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.0|[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"| |<|*Graph (Widget)*|1|graphid.\_reference|Instead of [Graph](/manual/api/reference/graph/get) ID:<br>`ABCDE._graphid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for graphs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Simple graph" and *Graph* is not set| |*Item*|<|4|itemid.0|[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" and *Item (Widget)* is not set| |<|*Item (Widget)*|1|itemid.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Simple graph" and *Item* is not set| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |*Show legend*|<|0|show_legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Override host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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|source_type|0 - *(per defecte)* Gràfic;<br>1 - Gràfic simple.| |*Gràfic*|<|6|graphid.0|[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"| |<|*Gràfic (Giny)*|1|graphid.\_reference|En lloc d'ID de [Gràfic](/manual/api/reference/graph/get):<br>`ABCDE._graphid` - estableix un [giny compatible ](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* establert a "`ABCDE`") com a font de dades per als gràfics.<br><br>[Comportament del paràmetre]( /manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Font* és establert a "Gràfic simple" i *Gràfic* no és pas definit| |*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"| |<|*Element (Giny)*|1|itemid.\_reference|En lloc d'ID de l'[Element](/manual/api/reference/item/get):<br>`ABCDE._itemid` - estableix un [giny compatible ](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* establert a "`ABCDE`") com a font de dades per als elements.<br><br>[Comportament del paràmetre]( /manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Font* és establert a "Gràfic simple" i *Element* no és pas definit| |<|*Període de temps*|1|time_period._reference|`DASHBOARD._timeperiod` - establir el [selector de *Període de temps*](/manual/web_interface/time_period_selector) com a font de dades.<br>`ABCDE._timeperiod` - estableix un giny compatible (*Gràfic*, *Gràfic (clàssic)* o *Prototip de gràfic* amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br>Alternativament, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.| |^|*Des de*|1|time_period.from|Cadena de temps vàlida en sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Període de temps* no s'ha definit| |^|*Fins a*|1|time_period.to|Cadena de temps vàlida en sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si no s'ha definit el *Període de temps*| |*Veure la llegenda*|<|0|show_legend|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Sobreescriure equip*|<|1|override_hostid._reference|`ABCDE._hostid` - establir un gint compatible (*Host navigator* amb el seu paràmetre *Referència* definit com a "`ABCDE`") com la font de dades que conté l'equip.<br>`DASHBOARD._hostid` - definir el [selector d'*Equip* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades continguent l'equip.<br><br>Aquest paràmetre no és admès si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Referència*|<|1|reference|Qualsevol valor de cadena que consisteix en 5 caràcters(p.e., `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únical tauler al que el giny pertany.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

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.0|[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.0|[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"| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |*Show legend*|<|0|show_legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Override host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Columns*|<|0|columns|Possible values range from 1-24.<br><br> Default: 2.| |*Rows*|<|0|rows|Possible values range from 1-16.<br><br> Default: 1.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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|source_type|2 - *(per defecte)* Prototip de gràfic;<br>3 - Prototip de gràfic simple.| |*Prototip de gràfic*|<|7|grafid.0|[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.0|[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"| |*Període de temps*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - estableix la [tria de *Període de temps*](/manual/web_interface/time_period_selector) com a font de dades;<br>`ABCDE._timeperiod ` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* definit a "`ABCDE`") com a font de dades.<br><br> Per defecte: `DASHBOARD._timeperiod`<br><br>Com alternativa, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.| |<|*Des de*|1|time_period.from|Cadena de temps vàlida en la sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) sintaxi temporal (`ara` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit| |^|*Fins a*|1|time_period.to|Cadena de temps vàlida en la sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`ara`) , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit| |*Mostra la llegenda*|<|0|mostra la llegenda|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Substitueix l'equip*|<|1|override_hostid.\_reference|`ABCDE._hostid` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips;<br>`DASHBOARD._hostid` - establiu el tauler [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com la font de dades dels equips.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Columnes*|<|0|columns|Els valors possibles oscil·len entre 1 i 24.<br><br> Per defecte: 2.| |*Fileres*|<|0|rows|Els valors possibles oscil·len entre 1 i 16.<br><br> Per defecte: 1.| |*Referència*|<|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha de ser únic dins del tauler de control al qual pertany el giny.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

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.| |*Reference*|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.| |*Referència*|1|reference|Qualsevol valor de cadena que tingui 5 caracters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler al que pertany el giny.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

en-us	### Parameters  The following parameters are supported for the *Honeycomb* 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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype_host|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|host_tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|host_tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|host_tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Item patterns*|<|1|items.0|[Item](/manual/api/reference/item/get) name or pattern.<br><br>Note: To configure multiple item patterns, create a dashboard widget field object for each item pattern with an incremented number in the property name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Item tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype_item|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|item_tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Operator*|0|item_tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Tag value*|1|item_tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |*Show hosts in maintenance*|<|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show*|<|0|show.0|1 - Primary label;<br>2 - Secondary label.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.<br><br>Default: 1, 2.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Bresca*.  |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.0|ID del [Grup d'equips](/manual/api/reference/hostgroup/get).<br><br>Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|[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 amb un nombre incrementat al nom de la propietat. 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.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'equips*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype_host|0 - *(per defecte)* I/O;<br>2 - O.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de control de plantilla ](/manual/api/reference/templatedashboard/object).| |^|*Nom de l'etiqueta*|1|host_tags.0.tag|Qualsevol valor de tipus cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |^|*Operador*|0|host_tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Valor de l'etiqueta*|1|host_tags.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[ Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |*Patrons d'element*|<|1|items.0|[Item](/manual/api/reference/item/get) nom o patró.<br><br>Nota: per configurar diversos patrons d'element, creeu un tauler de control objecte camp de giny per a cada patró d'element amb un nombre incrementat al nom de la propietat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |*Etiquetes d'element*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype_item|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|item_tags.0.tag|Qualsevol valor de tipus cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'està configurant *Etiquetes d'element*| |^|*Operador*|0|item_tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'element*| |^|*Valor de l'etiqueta*|1|item_tags.0.value|Qualsevol valor de tipus cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'està configurant *Etiquetes d'element*| |*Mostra els equips en manteniment*|<|0|manteniment|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Vista*|<|0|show.0|1 - Etiqueta principal;<br>2 - Etiqueta secundària.<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor amb un nombre incrementat al nom de la propietat.<br><br>Per defecte: 1, 2.| |*Referència*|<|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha de ser únic dins del tauler de control al qual pertany el giny.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Interface type*|<|0|interface_type.0|0 - None;<br>1 - Zabbix agent (passive checks);<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX;<br>5 - Zabbix agent (active checks).<br><br>Default: 1, 2, 3, 4, 5 (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.| |*Layout*|<|0|layout|0 - *(default)* Horizontal;<br>1 - Vertical.| |*Show hosts in maintenance*|<|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show only totals*|<|0|only_totals|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.0|[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 amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Tipus d'interfície*|0|interface_type.0|0 - Cap;<br>1 - Agent Zabbix (validacions passives);<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX;<5> - agent de Zabbix (validacions actives).<br><br>Per defecte. : 1, 2, 3, 4,5 (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor amb un nombre incrementat al nom de la propietat.| |*Disposició*|0|layout|0 - *(per defecte)* Horitzontal;<br>1 - Vertical.| |*Veure equips en manteniment*|0|maintenance|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Veure només els totals*|0|only_totals|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Host navigator* 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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host patterns*|<|1|hosts.0|[Host](/manual/api/reference/host/get) name or pattern.<br><br>Note: To configure multiple host patterns, create a dashboard widget field object for each host pattern with an incremented number in the property name. For multiple host patterns, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the hosts matching the configured host patterns belong to.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host status*|<|0|status|-1 - *(default)* Any;<br>0 - Enabled;<br>1 - Disabled.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host tags*|<|<|<|<| |<|*Evaluation type*|0|host_tags_evaltype|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|host_tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|host_tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|host_tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Severity*|<|0|severities.0|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 with an incremented number in the property name.| |*Show hosts in maintenance*|<|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show problems*|<|0|show_problems|0 - All;<br>1 - *(default)* Unsuppressed;<br>2 - None.| |*Group by*|<|<|<|<| |<|*Attribute*|0|group_by.0.attribute|0 - Host group;<br>1 - Tag value;<br>2 - Severity.<br><br>Note: The number in the property name references attribute order in the grouping attribute list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Group by*| |^|*Value*|1|group_by.0.tag_name|Any string value.<br><br>Note: The number in the property name references the grouping attribute set in the *Attribute* parameter.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Group by* and *Attribute* is set to "Tag value"| |*Host limit*|<|0|show_lines|Possible values range from 1-9999.<br><br>Default: 100.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Navegador d'equips*.  |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.0|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Patrons d'equips*|<|1|hosts.0|Nom o patró de l'[Equip](/manual/api/reference/host/get).<br><br>Nota: per configurar diversos patrons d'equips, creeu un tauler de control objecte camp de giny per a cada patró d'equip amb un nombre incrementat al nom de la propietat. Per a diversos patrons d'equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o amb almenys un grup d'equips al qual pertanyen els equips que coincideixen amb els patrons d'equips configurats.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object).| |*Estat de l'equip*|<|0|status|-1 - *(per defecte)* Qualsevol;<br>0 - Activat;<br>1 - Desactivat.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'equips*|<|<|<|<| |<|*Tipus d'avaluació*|0|host_tags_evaltype|0 - *(per defecte)* I/O;<br>2 - O.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Nom de l'etiqueta*|1|host_tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |^|*Operador*|0|host_tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/ objecte).| |^|*Valor de l'etiqueta*|1|host_tags.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |*Gravetat*|<|0|severities.0|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Valor per defecte: buit (tot activat).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor amb un nombre incrementat al nom de la propietat.| |*Veure equips en manteniment*|<|0|maintenance|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Veure problemes*|<|0|show_problems|0 - Tots;<br>1 - *(per defecte)* No suprimit;<br>2 - Cap.| |*Agrupar per*|<|<|<|<| |<|*Atribut*|0|group_by.0.attribute|0 - Grup d'equips;<br>1 - Valor de l'etiqueta;<br>2 - Gravetat.<br><br>Nota: el nombre a les referències del nom de la propietat ordre dels atributs a la llista d'atributs d'agrupació.<br><br>[Comportament dels paràmetres](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'està configurant *Agrupar per*| |^|*Valor*|1|group_by.0.tag_name|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'atribut d'agrupació establert al paràmetre *Atribut*.<br><br >[Comportament dels paràmetres](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *Agrupa per* i *Atribut* s'estableix a "Valor de l'etiqueta"| |*Límit de l'equip*|<|0|show_lines|Els valors possibles oscil·len entre 1 i 9999.<br><br>Per defecte: 100.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla ](/manual/api/reference/templatedashboard/object).| |*Referència*|<|1|reference|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic dins del tauler de control al qual pertany el giny.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

en-us	### Parameters  The following parameters are supported for the *Item history* 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.| |*Layout*|0|layout|0 - *(default)* Horizontal;<br>1 - Vertical.| |*Columns* (see [below](#columns))|<|<|<| |*Show lines*|0|show_lines|Possible values range from 1-100.<br><br>Default: 25.| |*Override host*|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Advanced configuration* (see [below](#advanced-configuration))|<|<|<| |*Reference*|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Historial d'elements*.  |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.| |*Disposició*|0|layout|0 - *(per defecte)* Horitzontal;<br>1 - Vertical.| |*Columnes* (veieu [a sota](#columns))|<|<|<| |*Mostra les línies*|0|show_lines|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 25.| |*Substitueix l'equip*|1|override_hostid._reference|`ABCDE._hostid` - estableix un giny compatible (*Navegador de l'equip* amb el seu paràmetre *Reference* establert a "`ABCDE`") com a font de dades que conté l'equip.< br>`DASHBOARD._hostid` - defineix el tauler [selector d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades que conté l'equip.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Configuració avançada* (veieu [a sota](#configuració-avançada))|<|<|<| |*Referència*|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha de ser únic dins el tauler de control al que pertany el giny.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

en-us	### Parameters  The following parameters are supported for the *Item navigator* 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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostid` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host tags*|<|<|<|<| |<|*Evaluation type*|0|host_tags_evaltype|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|host_tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|host_tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|host_tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Item patterns*|<|1|items.0|[Item](/manual/api/reference/item/get) name or pattern.<br><br>Note: To configure multiple item patterns, create a dashboard widget field object for each item pattern with an incremented number in the property name.| |*Item tags*|<|<|<|<| |<|*Evaluation type*|0|item_tags_evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|item_tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Operator*|0|item_tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Tag value*|1|item_tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |*State*|<|0|state|-1 - *(default)* All;<br>0 - Normal;<br>1 - Not supported.| |*Show problems*|<|0|show_problems|0 - All;<br>1 - *(default)* Unsuppressed;<br>2 - None.| |*Group by*|<|<|<|<| |<|*Attribute*|0|group_by.0.attribute|0 - Host group;<br>1 - Host name;<br>2 - Host tag value;<br>3 - Item tag value.<br><br>Note: The number in the property name references attribute order in the grouping attribute list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Group by*| |^|*Value*|1|group_by.0.tag_name|Any string value.<br><br>Note: The number in the property name references the grouping attribute set in the *Attribute* parameter.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Group by* and *Attribute* is set to "Host tag value" or "Item tag value"| |*Item limit*|<|0|show_lines|Possible values range from 1-9999.<br><br>Default: 100.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Navegador d'elements*.  |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.0|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|2|hostids.0|[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 amb un nombre incrementat al nom de la propietat. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o amb almenys un grup d'equips al qual pertanyen els equips configurats.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'equips*|<|<|<|<| |<|*Tipus d'avaluació*|0|host_tags_evaltype|0 - *(per defecte)* I/O;<br>2 - O.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Nom de l'etiqueta*|1|host_tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |^|*Operador*|0|host_tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/ objecte).| |^|*Valor de l'etiqueta*|1|host_tags.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[ Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla] (/manual/api/reference/templatedashboard/object).| |*Patrons d'element*|<|1|items.0|[Element](/manual/api/reference/item/get) nom o patró.<br><br>Nota: per configurar diversos patrons d'element, creeu un tauler objecte camp de giny per a cada patró d'element amb un nombre incrementat al nom de la propietat.| |*Etiquetes d'element*|<|<|<|<| |<|*Tipus d'avaluació*|0|item_tags_evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|item_tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'està configurant *Etiquetes d'element*| |^|*Operador*|0|item_tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):<br>- *obligatori* si es configura *etiquetes d'element*| |^|*Valor de l'etiqueta*|1|item_tags.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'està configurant *Etiquetes d'element*| |*Estat*|<|0|state|-1 - *(per defecte)* Tots;<br>0 - Normal;<br>1 - No s'admet.| |*Veure problemes*|<|0|show_problems|0 - Tots;<br>1 - *(per defecte)* No esborrat;<br>2 - Cap.| |*Agrupa per*|<|<|<|<| |<|*Atribut*|0|group_by.0.attribute|0 - Grup d'equips;<br>1 - Nom de l'equip;<br>2 - Valor de l'etiqueta de l'equip;<br>3 - Valor de l'etiqueta de l'element.<br>< br>Nota: el nombre del nom de la propietat fa referència a l'ordre dels atributs a la llista d'atributs d'agrupació.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si configurant *Agrupa per*| |^|*Value*|1|group_by.0.tag_name|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'atribut d'agrupació establert al paràmetre *Atribut*.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es configura *Agrupar per* i *Atribut* defineix com a "Valor de l'etiqueta de l'equip" o "Valor de l'etiqueta de l'element"| |*Límit d'elements*|<|0|show_lines|Els valors possibles oscil·len entre 1 i 9999.<br><br>Per defecte: 100.| |*Referència*|<|1|reference|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE` o `JBPNL`). Aquest valor ha de ser únic dins del tauler de control al qual pertany el giny.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

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.0|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Item (Widget)* is not set| |<|*Item (Widget)*|1|itemid.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Item* is not set| |*Show*|<|0|show.0|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 with an incremented number in the property name.| |*Override host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).|
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|itemid.0|ID de l'[Element](/manual/api/reference/item/get).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |<|*Element (Giny)*|1|itemid.\_reference|En lloc de l'id de l'[Element](/manual/api/reference/item/get):<br>`ABCDE._itemid` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als elements.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si no s'ha definit *Element*| |*Veure*|<|0|show.0|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.| |*Substitueix l'equip*|<|1|override_hostid.\_reference|`ABCDE._hostid` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* definit en "`ABCDE`") com a font de dades que conté l'equip.<br>`DASHBOARD._hostid` - defineix el tauler [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades que conté l'equip.<br><br>Aquest paràmetre és no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|

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` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<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.1.name|Any string value.<br><br>Note: The number in the property name sets the element number.| |*Linked map*|8|navtree.1.sysmapid|[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.1.parent|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.1.order|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.| |*Map*|<|8|sysmapid.0|[Map](/manual/api/reference/map/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Map (Widget)* is not set| |<|*Map (Widget)*|1|sysmapid.\_reference|`ABCDE._mapid` - set a [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree) widget (with its *Reference* parameter set to "`ABCDE`") as the data source for maps.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Map* is not set| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.| |*Mapa*|<|<|<|<| |^|*Mapa*|<|8|sysmapid.0|[Mapa](/manual/api/reference/map/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori* si no s'ha definit el *Giny*| |^|*Mapa (Giny)*|<|1|sysmapid\._reference|`ABCDE._mapid` - estableix un giny [*Arbre de navegació del mapa*](/manual/api/reference/dashboard/widget_fields/map_tree) (amb el seu paràmetre *Referència* definit a "`ABCDE`") com a origen de font que conté els mapes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si no s'ha definit *Mapa*| |*Referència*|<|1|reference|Quasevol valor de cadena consistent en 5 caràcters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on el giny pertany.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *Obligatori*|

en-us	### Parameters  The following parameters are supported for the *Pie chart* 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 de pastís*.  |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 *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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Exclude host groups*|<|2|exclude_groupids.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities.0|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 with an incremented number in the property name.| |*Problem tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem display*|<|0|ext_ack|0 - *(default)* All;<br>1 - Unacknowledged only;<br>2 - Separated.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).|.| |*Equips*|<|3|hostids.0|[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.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*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).| |*Gravetat*|<|0|severities.0|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 amb un nombre incrementat a la propietat del nom.| |*Etiquetes de problemes|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: El nombre a la propietat del nom fa referència a l'ordre d'etiqueta al llistat d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes de problemes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes de problemes*| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes de problemes*| |*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.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |*Visualització del problema*|<|0|ext_ack|0 - *(per defecte)* Tots;<br>1 - Només no reconegut;<br>2 - Separat.| |*Referència*|<|1|reference|Quasevol valor de cadena consistent en 5 caràcters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on el giny pertany.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *Obligatori*|

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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Exclude host groups*|<|2|exclude_groupids.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities.0|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 with an incremented number in the property name.| |*Problem tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |*Show*|<|0|show_type|0 - *(default)* Host groups;<br>1 - Totals.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), and by default is set to "Totals".| |*Layout*|<|0|layout|0 - *(default)* Horizontal;<br>1 - Vertical.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show* is set to "Totals"| |*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 behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show* is set to "Host groups"<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*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.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Excloure els grups d'equips*|<|2|exclude_groupids.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|[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 amb, com a mínim, un grup d'equips al qui pertanyin els equips configurats.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*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|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 amb un nombre incrementat a la propietat del nom.| |*Etiquetes de problemes*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes de problemes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix..<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes de problemes*| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena..<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes de problemes*| |*Visualització*|<|0|show_type|0 - *(per defecte)* Grups d'equips;<br>1 - Totals.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object), i per defecte és establert a "Totals".| |*Disposició*|<|0|layout|0 - *(per defecte)* Horitzontal;<br>1 - Vertical.<br><br>[Comportament de paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* Si *Visualització* és establert a "Totals".| |*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>[Comportament de paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* Si *Visualització* és establert a "Grups d'equips"<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |*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|show_timeline|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Referència*|<|1|reference|Quasevol valor de cadena consistent en 5 caràcters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on el giny pertany.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *Obligatori*|

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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Exclude host groups*|<|2|exclude_groupids.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities.0|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 with an incremented number in the property name.| |*Problem tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem 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 behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show tags* is set to "1", "2", or "3"| |*Tag display priority*|<|1|tag_priority|Comma-separated list of tags.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show tags* is set to "1", "2", or "3"| |*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.| |*Acknowledgement status*|<|0|acknowledgement_status|0 - *(default)* all;<br>1 - Unacknowledged; <br>2 - Acknowledged.| |*By me*|<|0|acknowledged_by_me|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 *Show timeline* parameter must be set to "Disabled".<br><br>Values "Host (ascending)" and "Host (descending)" are not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Show timeline*|<|0|show_timeline|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Sort entries by* is set to "Time (descending)" or "Time (ascending)"| |*Show lines*|<|0|show_lines|Possible values range from 1-100.<br><br>Default: 25.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.0|[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 amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Excloure 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 amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|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.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*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).| |*Gravetat*|<|0|severities.0|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 de problemes*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: el nombre al nom de la propietat fa referència a l'ordre d'etiquetes a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.<br><br>Nota: el nombre al nom de la propietat fa referència a l'ordre d'etiquetes a la llista d'avaluació d'etiquetes.<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.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre al nom de la propietat fa referència a l'ordre d'etiquetes a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |*Veure etiquetes*|<|0|show_tags|0 - *(per defecte)* Cap;<br>1 - 1;<br>2 - 2;<br>3 - 3.| |*Nom de l'etiqueta* (format)|<|0|tag_name_format|0 - *(per defecte)* Complet;<br>1 - Escurçat;<br>2 - Cap.<br><br>[Comportament del paràmetre behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* if *Veure etiquetes* és establert a "1", "2", o "3"| |*Prioritat de visualització de l'etiqueta*|<|1|tag_priority|Llistat d'etiquetes separades per comes.<br><br>[Comportament del paràmetre behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* if *Veure etiquetes* és establert a "1", "2", o "3"| |*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.| |*Estat de reconeixement*|<|0|acknowledgement_status|0 - *(per defecte)* tot;<br>1 - No reconegut;<br>2 - Reconegut.| |*Per mi*|<|0|acknowledged_by_me|0 - *(per defecte)* Desactivat;<br>1 - Actiu.| |*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".<br><br>Els valors "Equip (ascendent)" i  "Equip (descendent)" no s'admeten pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*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.| |*Referència*|<|1|reference|Quasevol valor de cadena consistent en 5 caràcters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on el giny pertany.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *Obligatori*|

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.0|[SLA](/manual/api/reference/sla/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Service*|9|serviceid.0|[Service](/manual/api/reference/service/get) ID.| |*Show periods*|0|show_periods|Possible 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/web_interface/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/web_interface/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.| |*Show software update check details*|0|show_software_update_check_details|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if [`AllowSoftwareUpdateCheck`](/manual/appendix/config/zabbix_server#allowsoftwareupdatecheck) in Zabbix server configuration is enabled and *Show* is set to "System stats"|
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.| |*Veure els detalls de la comprovació de l'actualització del programari*|0|ensenya els detalls de la verificació de l'actualització del programari|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):<br>- *admès* si [`AllowSoftwareUpdateCheck`](/manual/appendix/config/zabbix_server#allowsoftwareupdatecheck) a la configuració del servidor Zabbix és habilitat i *Veure* és establert a "Estat del sistema"|

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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Show hosts in maintenance*|<|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.| |*Columns* (see below)|<|<|<|<| |*Order by*|<|0|column|Column numeric value from the configured columns.| |*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.| |*Host limit*|<|0|show_lines|Possible values range from 1-100.<br><br>Default: 10.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).|
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.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|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.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'equips*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes d'equips*<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |*Veure els equips en manteniment*|<|0|maintenance|0 - *(per defecte)* Desactivat;<br>1 - Actiu.| |*Columnes* (veieu més avall)|<|<|<|<| |*Ordenar per*|<|0|column|Valor numèric de columna de les columnes configurades.| |*Ordre*|<|0|order|2 - *(per defecte)* N superior;<br>3 - N. inferior| |*Límit d'equips*|<|0|show_lines|El rang de possibles valors és 1-100.<br><br>Default: 10.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).|

en-us	### Parameters  The following parameters are supported for the *Top triggers* 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.| |*Host groups*|<|2|groupids.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities.0|Trigger severities.<br><br>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 with an incremented number in the property name.| |*Problem tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |*Trigger limit*|<|0|show_lines|Possible values range from 1-100.<br><br>Default: 10.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Triggers principals*.  |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.| |*Grups d'equips*|<|2|groupids.0|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|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 amb un nombre incrementat al nom de la propietat. Per 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.<br><br>Aquest paràmetre no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*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).| |*Gravetat*|<|0|severities.0|Severitat del desencadenant.<br><br>0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br >4 - Alta;<br>5 - Desastre.<br><br>Valor predeterminat: buit (tot activat).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny del tauler de control per a cada valor amb un nombre incrementat al nom de la propietat.| |*Etiquetes de problemes*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[ Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes de problemes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary #parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes de problemes*| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes de problemes*| |*Període de temps*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - estableix el [selector de *Període de temps*](/manual/web_interface/time_period_selector) com a font de dades.<br>`ABCDE._timeperiod` - establiu un giny compatible (*Gràfic*, *Gràfic (clàssic)* o *Prototipus de gràfic* amb el seu paràmetre *Referència* definit en "`ABCDE`") com a font de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br>Alternativament, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.| |<|*Des de*|1|time_period.from|Cadena de temps vàlida a la sintaxi temporal absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`), `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit| |^|*Fins a*|1|time_period.to|Cadena de temps vàlida en la sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`), `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit| |*Límit d'activació*|<|0|show_lines|Els valors possibles 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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Problem tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Problem 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.| |*Veure*|<|0|show|1 - *(per defecte)* Problemes recents;<br>2 - Qualsevol;<br>3 - Problemes.| |*Grups d'equips*|<|2|groupids.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|ID d'[Equip](/manual/api/reference/host/get).<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.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*Etiquetes de problemes*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<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.0.value|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Veure els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Ubicació de l'equip*|<|0|style|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*| |*Override host*|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).|
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*| |*Sobreescriure equip*|1|override_hostid.\_reference|`ABCDE._hostid` - etableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (*Navegador d'equips* amb el seu paràmetre *Referència* definit a "`ABCDE`") com a la font de dades que conté l'equip.<br>`DASHBOARD._hostid` - establir el tauler de [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com la font de dades que conté l'equip.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).|

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.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Exclude host groups*|<|2|exclude_groupids.0|[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 with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. 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.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Scenario tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |^|*Operator*|0|tags.0.operator|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>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |*Show hosts in maintenance*|<|0|maintenance|0 - Disabled;<br>1 - *(default)* Enabled.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
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.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.\_reference|En lloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no és compatible si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Exclou els grups d'equips*|<|2|exclude_groupids.0|[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 amb un nombre incrementat a la propietat del nom.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|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 *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.<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilles](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|En lloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - establiu la [Tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - establiu un [giny compatible](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Referència* establert a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet si es configura el giny a una [plantilla tauler de control](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'escenari*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'han configurat *Etiquetes d'escenari*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'han configurat *Etiquetes d'escenari*| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena.<br><br>Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'han configurat *Etiquetes d'escenari*| |*Mostra equips en manteniment*|<|0|manteniment|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.| |*Referència*|<|1|reference|Quasevol valor de cadena consistent en 5 caràcters (com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on el giny pertany.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *Obligatori*|

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/en/manual/config/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.  ```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. `7.0`) -   `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.  ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ```  **Assegureu-vos** d'especificar el nom correcte de la branca; per exemple, substituiu `branchname` (veieu la segona línia) amb el següent:  - `release/*` - per la branca estable, on "\*" és la versió de llençament (p.e. `7.0`) - `master` - per la branca principal - `<commit hash>` - per una versió específica (empreu el hash de la branca específica)  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. Refresh Zabbix frontend. Click on *My address → External IP* 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. Recarregueu la interfície Zabbix. Feu clic a *La meva adreça → IP Externa* 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 and then add a nested menu to it. 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"}  3. To add nested pages to the *My Address* menu section, open and edit the *Module.php* file again.  This step creates two subsections:  -   *External IP* that executes a new 'my.address' action that will be defined in the next steps; -   *User profile* that executes the predefined 'userprofile.edit' action to open the *User profile* page.  Note that for the nested menu, you need to use the *CMenu* class in addition to the classes used in the previous steps.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenu,     CMenuItem;  class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))             ->getSubmenu()             ->insertAfter(_('Discovery'),                 (new CMenuItem(_('My Address')))->setSubMenu(                     new CMenu([                         (new CMenuItem(_('External IP')))->setAction('my.address'),                         (new CMenuItem(_('User profile')))->setAction('userprofile.edit')                     ])                 )             );     } } ```  4. Refresh Zabbix frontend. Observe that the *My address* menu section now contains a third-level menu with two pages - *External IP* and *User profile*.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_nested.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"}   3. Per afegir pàgines niuades a la secció de menú *La meva adreça*, obriu i editeu de nou el fitxer *Module.php*.  Aquesta passa crea dues subseccions:  -     *IP externa* que executa una nova acció "my.address" que es definirà a les passes següents; -     *Perfil d'usuari* que executa l'acció predefinida 'userprofile.edit' per obrir la pàgina *Perfil d'usuari*.  Tingueu en compte que per al menú niuat, heu d'emprar la classe *CMenu* a més de les classes utilitzades a les passes anteriors.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,      APP,      CMenu,      CMenuItem;  class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))             ->getSubmenu()             ->insertAfter(_('Discovery'),                 (new CMenuItem(_('My Address')))->setSubMenu(                     new CMenu([                         (new CMenuItem(_('External IP')))->setAction('my.address'),                         (new CMenuItem(_('User profile')))->setAction('userprofile.edit')                     ])                 )             );     } } ```  4. Recarregueu la interfície de Zabbix. Fixeu-vos que la secció de menú *La meva adreça* ara conté un tercer nivell de menú amb dues pàgines - *IP Externa* i *Perfil d'usuari*.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_nested.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	 Partitioning the `auditlog` table can improve, for example, housekeeping in large setups. Although Zabbix [housekeeping](/manual/web_interface/frontend_sections/administration/housekeeping) currently cannot take advantage of partitioned tables (except for TimescaleDB), you can disable Zabbix housekeeping and delete partitions using scripts.  Since Zabbix 7.0, the `auditlog` table for TimescaleDB has been converted to a hypertable, which allows the housekeeper to drop data by chunks. To upgrade the existing `auditlog` table to a hypertable, rerun the `postgresql/timescaledb/schema.sql` script before starting Zabbix server. Zabbix server will log a warning, if started without running this script first. See also: [TimescaleDB setup](/manual/appendix/install/timescaledb#configuration).
ca	 Particionar la taula `auditlog` pot millorar, per exemple, la neteja en configuracions grans. Tot i que la [neteja](/manual/web_interface/frontend_sections/administration/housekeeping) a Zabbix actualment no pot aprofitar les taules particionades (excepte TimescaleDB), podeu desactivar la neteja Zabbix i esborrar particions mitjançant scripts.  Des de Zabbix 7.0, la taula `auditlog` de TimescaleDB s'ha convertit en una hipertaula, que permet que la neteja esborri dades per trossos. Per actualitzar la taula `auditlog` existent a una hipertaula, torneu a executar l'script `postgresql/timescaledb/schema.sql` abans d'engegar el servidor Zabbix. El servidor Zabbix registrarà un avís si s'engega sense executar aquest script abans. Veieu també: [Configuració de TimescaleDB](/manual/appendix/install/timescaledb#configuration).

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.  :::
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. :::

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.  Passive checks are executed asynchronously - it is not required to receive the response to one request before other checks are started. DNS resolving is asynchronous as well.  The maximum concurrency of asynchronous checks is 1000 (defined by [MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)).  The number of asynchronous agent pollers is defined by the [StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers) parameter.  **Server request**  For definition of header and data length please refer to [protocol details](/manual/appendix/protocols/header_datalen).  ```json {   "request": "passive checks",   "data": [     {       "key": "agent.version",       "timeout": 3     }   ] } ```  **Agent response**  ```json {   "version": "7.0.0",   "variant": 2,   "data": [     {       "value": "7.0.0"     }   ] } ```  For example, for supported items:  1.  Server opens a TCP connection 2.  Server sends **<HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"value":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>{"request":"passive checks","data":[{"key":"vfs.fs.size\[/nono\]","timeout":3}]}** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}** 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.  Les comprovacions passives s'executen de manera asíncrona - no cal rebre la resposta a una petició abans que s'iniciïn altres comprovacions. La resolució de DNS també és asíncrona.  La concurrència màxima de comprovacions asíncrones és 1000 (definida per [MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)).  El nombre de pollers d'agents asíncrons el defineix el paràmetre [StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers).  **Petició al servidor**  Per la definició de l'encapçalament i la longitud de les dades, veieu els [detalls del protocol](/manual/appendix/protocols/header_datalen).  ```json {   "request": "passive checks",   "data": [     {       "key": "agent.version",       "timeout": 3     }   ] } ```  **Agent response**  ```json {   "version": "7.0.0",   "variant": 2,   "data": [     {       "value": "7.0.0"     }   ] } ```  Per exemple, per elements admesos:  1. El servidor obre una connexió TCP 2. El servidor envia **<HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}** 3. L'agent llegeix la petició i respon amb   **<HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"value":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>{"request":"passive checks","data":[{"key":"vfs.fs.size\[/nono\]","timeout":3}]}** 3. L'agent llegeix la petició i respon amb   **<HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}** 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 formatting rules  Whitespaces (space, tab character) can be used in bracket notation segments and expressions, for example: `$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( )`.  Strings should be enclosed with single (`'`) or double (`"`) quotes. Inside the strings, single or double quotes (depending on which are used to enclose it) and backslashes (`\`) are escaped with the backslash (`\`) character.
ca	#### Regles de format del camí  Els espais en blanc (espai, caràcter de tabulació) es poden emprar en segments i expressions de notació de claudàtors, per exemple: `$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first ( )`.  Les cadenes s'han de tancar amb cometes simples (`'`) o dobles (`"`). Dins de les cadenes, les cometes simples o dobles (segons quines s'utilitzin per tancar-la) i les barres invertides (`\`) s'escapen amb el caràcter de barra invertida (`\`).

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": "7.0.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 hagueu 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 petició HTTP per cridar al mètode `apiinfo.version` pot assemblar-se a:  ``` bash curl --request POST \      --url 'http://example.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 `Content-Type` 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": "7.0.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 (mandatory for any newly created user) that can only be changed by a *Super admin* user.  ::: noteimportant 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 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*, *Super admin*) 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, mentre que 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|ID|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|ID|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>] {#pgsql.archive}  <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>] {#pgsql.archive}  <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>] {#pgsql.autovacuum.count}  <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>] {#pgsql.autovacuum.count}  <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>] {#pgsql.bgwriter}  <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>] {#pgsql.bgwriter}  <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>] {#pgsql.cache.hit}  <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>] {#pgsql.cache.hit}  <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>] {#pgsql.connections}  <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>] {#pgsql.connections}  <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>] {#pgsql.db.age}  <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>] {#pgsql.db.age}  <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>] {#pgsql.db.discovery}  <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>] {#pgsql.db.discovery}  <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>] {#pgsql.db.size}  <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>] {#pgsql.db.size}  <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>] {#pgsql.dbstat.sum}  <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>] {#pgsql.dbstat.sum}  <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>] {#pgsql.dbstat}  <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>] {#pgsql.dbstat}  <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>] {#pgsql.locks}  <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>] {#pgsql.locks}  <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>] {#pgsql.oldest.xid}  <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>] {#pgsql.oldest.xid}  <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>] {#pgsql.ping}  <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>] {#pgsql.ping}  <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>] {#pgsql.queries}  <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>] {#pgsql.queries}  <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>] {#pgsql.replication.count}  <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>] {#pgsql.replication.count}  <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>] {#pgsql.replication.process.discovery}  <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>] {#pgsql.replication.process.discovery}  <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>] {#pgsql.replication.process}  <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>] {#pgsql.replication.process}  <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>] {#pgsq.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>] {#pgsql.replication.status}  <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>] {#pgsql.replication.status}  <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>] {#pgsql.uptime}  <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>] {#pgsql.uptime}  <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>] {#pgsql.version}  <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>] {#pgsql.version}  <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>] {#pgsql.wal.stat}  <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>] {#pgsql.wal.stat}  <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	##### 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	#### Pie chart and Graph data source options  The "Item list" type data sets for [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set) and [*Pie chart*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart#data-set) widgets now support selecting compatible widgets as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for items.
ca	#### Opcions de font de dades de gràfic circular i gràfic  Els conjunts de dades de tipus "Llistat d'elements" per als ginys [*Gràfic*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set) i [*Gràfic circular*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart#data-set) ara admeten la selecció de ginys compatibles com a [font de dades](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) per als elements.

en-us	 #### Pie chart  A *Pie chart* widget has been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets), allowing to display values of selected items as:  -   **pie** chart; -   **doughnut** chart.  |  |  | |-|-| |![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_chart_7_0.png){width="300"}<br>Pie chart.|![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/doughnut_chart_7_0.png){width="300"}<br>Doughnut chart.|  For more information, see [*Pie chart*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart).  As part of this development, a *Show aggregation function* checkbox has been added to the [graph](/manual/web_interface/frontend_sections/dashboards/widgets/graph#legend)  widget configuration (in *Legend* tab).
ca	 #### Gràfic de pastís  S'ha afegit un giny *gràfic de pastís* a [widgets del tauler de control](/manual/web_interface/frontend_sections/dashboards/widgets), que permet mostrar els valors dels elements seleccionats com:  -  Gràfic de **pastís**; - Gràfic de **dònut**.  |  |  | |-|-| |![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_chart_7_0.png){width="300"}<br>Diagrama de sectors.|![](.. /../../assets/en/manual/web_interface/frontend_sections/monitoring/doughnut_chart_7_0.png){width="300"}<br>Gràfic de donuts.|  Per obtindre més informació, veieu [*Gràfic de pastís*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart).  Com a part d'aquest desenvolupament, s'ha afegit una casella de selecció *Mostra la funció d'agregació* al [gràfic](/manual/web_interface/frontend_sections/dashboards/widgets/graph#legend)  configuració del giny (a la pestanya *Llegenda*).

en-us	#### Pie chart visual options  With the [*Pie chart*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart#displaying-options) widget set to display a doughnut chart, you can now configure the *Stroke width* parameter - the width of the chart sector border.  Additionally, when hovering over a sector, it now enlarges outward for a smoother visual effect, replacing the previous pop-out behavior.
ca	#### Opcions visuals del gràfic circular  Amb el giny [*Gràfic de pastís*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart#displaying-options) configurat per mostrar un gràfic en forma de dònut, ara podeu configurar el paràmetre *Amplada del traç* - l'amplada del marge del sector del gràfic.  A més, quan es passa el cursor per sobre d'un sector, ara s'amplia cap a l'exterior per obtindre un efecte visual més suau, substituint el comportament emergent anterior.

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

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   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