[comment]: # ({bc57ee5e-e5d5266e})
# 29 Populārākie vienumi
[comment]: # ({/bc57ee5e-e5d5266e})
[comment]: # ({b96fa072-b8507936})
### Apraksts
Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Top items*](/manual/web_interface/frontend_sections/dashboards/widgets/top_items) logrīku `dashboard.create` un `dashboard.update` metodēs.
::: noteimportant
Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā.
Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi.
Lai nodrošinātu veiksmīgu *Top items* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību.
:::
[comment]: # ({/b96fa072-b8507936})
[comment]: # ({612eaf3d-2a023c70})
### Parametri
Tālāk norādītie parametri tiek atbalstīti logrīkam *Top items*.
|Parametrs|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Atsvaidzināšanas intervāls*|<|0|rf_rate|0 - Bez atsvaidzināšanas;
10 - 10 sekundes;
30 - 30 sekundes;
60 - *(noklusējums)* 1 minūte;
120 - 2 minūtes;
600 - 10 minūtes;
900 - 15 minūtes.|
|*Hostu grupas*|<|2|groupids.0|[Hostu grupas](/manual/api/reference/hostgroup/get) ID.
Piezīme: Lai konfigurētu vairākas hostu grupas, izveidojiet dashboard logrīka lauka objektu katrai hostu grupai ar palielinātu numuru īpašības nosaukumā.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|<|*Hostu grupas (logrīks)*|1|groupids.\_reference|[Hostu grupas](/manual/api/reference/hostgroup/get) ID vietā:
`ABCDE._hostgroupids` - iestatiet [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā parametru *Reference*, kas iestatīts uz "`ABCDE`") kā datu avotu hostu grupām.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|*Hosti*|<|3|hostids.0|[Hosta](/manual/api/reference/host/get) ID.
Piezīme: Lai konfigurētu vairākus hostus, izveidojiet dashboard logrīka lauka objektu katram hostam ar palielinātu numuru īpašības nosaukumā. Ja ir vairāki hosti, parametrs *Hostu grupas* vai nu vispār nedrīkst būt konfigurēts, vai arī tam jābūt konfigurētam ar vismaz vienu hostu grupu, kurai pieder konfigurētie hosti.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|<|*Hosti (logrīks/panelis)*|1|hostids.\_reference|[Hosta](/manual/api/reference/host/get) ID vietā:
`DASHBOARD.hostids` - iestatiet paneļa [hostu atlasītāju](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) kā datu avotu hostiem;
`ABCDE._hostids` - iestatiet [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā parametru *Reference*, kas iestatīts uz "`ABCDE`") kā datu avotu hostiem.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|*Hostu birkas*|<|<|<|<|
|<|*Novērtēšanas tips*|0|host_tags_evaltype|0 - *(noklusējums)* Un/Vai;
2 - Vai.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|^|*Birkas nosaukums*|1|host_tags.0.tag|Jebkura virknes vērtība.
Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Hostu birkas*
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|^|*Operators*|0|host_tags.0.operator|0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.
Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Hostu birkas*
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|^|*Birkas vērtība*|1|host_tags.0.value|Jebkura virknes vērtība.
Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Hostu birkas*
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
|*Izkārtojums*|<|0|layout|0 - *(noklusējums)* Horizontāls;
1 - Vertikāls.|
|*Rādīt problēmas*|<|0|show_problems|0 - Visas;
1 - *(noklusējums)* Nenoklusinātās;
2 - Nav.|
|*Vienumi* (skatīt zemāk)|<|<|<|<|
[comment]: # ({/612eaf3d-2a023c70})
[comment]: # ({2cd9fffe-advanced})
#### Paplašinātā konfigurācija
Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti logrīkam *Top items*.
|Parametrs|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|***Hostu kārtošana***|<|<|<|<|
|*Kārtot pēc*|<|0|host_ordering_order_by|0 - *(noklusējums)* Hosta nosaukums;
3 - Vienuma vērtība.|
|<|*Vienumu šabloni*|1|host_ordering_item.0|[Vienuma](/manual/api/reference/item/get) nosaukums vai šablons (piemēram, "\*: Apstrādāto \*vērtību skaits sekundē").
Piezīme: Lai konfigurētu vairākus vienumu šablonus, izveidojiet dashboard widget field object katram vienuma šablonam, īpašības nosaukumā palielinot numuru.
Konfigurējot logrīku [veidnes panelī](/manual/api/reference/templatedashboard/object), jānorāda tikai to vienumu šabloni, kas konfigurēti veidnē.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja *Kārtot pēc* ir iestatīts uz "Vienuma vērtība"|
|*Secība*|<|0|host_ordering_order|2 - *(noklusējums)* Augšējie N;
3 - Apakšējie N.|
|*Limits*|<|0|host_ordering_limit|Iespējamās vērtības ir diapazonā no 1 līdz 100.
Noklusējums: 10.|
|***Vienumu kārtošana***|<|<|<|<|
|*Kārtot pēc*|<|0|item_ordering_order_by|1 - Hosts;
2 - Vienuma nosaukums;
3 - *(noklusējums)* Vienuma vērtība.|
|<|*Hostu šabloni*|1|item_ordering_host.0|[Hosta](/manual/api/reference/host/get) nosaukums vai šablons.
Piezīme: Lai konfigurētu vairākus hostu šablonus, izveidojiet dashboard widget field object katram hosta šablonam, īpašības nosaukumā palielinot numuru.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja *Kārtot pēc* ir iestatīts uz "Hosts"|
|*Secība*|<|0|item_ordering_order|2 - *(noklusējums)* Augšējie N;
3 - Apakšējie N.|
|*Limits*|<|0|item_ordering_limit|Iespējamās vērtības ir diapazonā no 1 līdz 100.
Noklusējums: 10.|
[comment]: # ({/2cd9fffe-advanced})
[comment]: # ({e913fe7b-f35f175e})
### Kolonnas
::: noteclassic
Pirmais skaitlis īpašības nosaukumā (piemēram, columns.0.items.0, columns.0.item_tags_evaltype) apzīmē konkrēto kolonnu, savukārt otrais skaitlis, ja tāds ir, apzīmē konfigurēto entītiju (piemēram, vienuma šablonu, birku).
:::
|Parametrs|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Vienumu šabloni*|<|1|columns.0.items.0|[Vienuma](/manual/api/reference/item/get) nosaukums vai šablons (piemēram, "\*: Apstrādāto \*vērtību skaits sekundē").
Piezīme: Lai konfigurētu vairākus vienumu šablonus, izveidojiet dashboard logrīka lauka objektu katram vienuma šablonam ar palielinātu otro skaitli īpašības nosaukumā.
Konfigurējot logrīku [veidnes dashboard](/manual/api/reference/templatedashboard/object), jāiestata tikai to vienumu šabloni, kas konfigurēti veidnē.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*|
|*Vienumu birkas*|<|<|<|<|
|<|*Novērtēšanas tips*|0|columns.0.item_tags_evaltype|0 - *(noklusējums)* Un/Vai;
2 - Vai.|
|^|*Birkas nosaukums*|1|columns.0.item_tags.0.tag|Jebkura virknes vērtība.
Piezīme: Otrais skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Vienumu birkas*|
|^|*Operators*|0|columns.0.item_tags.0.operator|0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.
Piezīme: Otrais skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Vienumu birkas*|
|^|*Birkas vērtība*|1|columns.0.item_tags.0.value|Jebkura virknes vērtība.
Piezīme: Otrais skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurētas *Vienumu birkas*|
|*Pamatkrāsa*|<|1|columns.0.base_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).|
|*Rādīt vērtību kā*|<|0|columns.0.display_value_as|1 - *(noklusējums)* Skaitliski;
2 - Teksts.|
|*Attēlojums*|<|0|columns.0.display|1 - *(noklusējums)* Kā ir;
2 - Josla;
3 - Indikatori;
6 - Sparkline.|
|*Min*|<|1|columns.0.min|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G").
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski" un *Attēlojums* ir iestatīts uz "Josla" vai "Indikatori"|
|*Max*|<|1|columns.0.max|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G").
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski" un *Attēlojums* ir iestatīts uz "Josla" vai "Indikatori"|
|*Sparkline*|<|<|<|<|
|<|*Platums*|0|columns.0.sparkline.width|Iespējamās vērtības ir diapazonā no 0 līdz 10.
Noklusējums: 1.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"|
|^|*Aizpildījums*|0|columns.0.sparkline.fill|Iespējamās vērtības ir diapazonā no 0 līdz 10.
Noklusējums: 3.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"|
|^|*Krāsa*|1|columns.0.sparkline.color|Heksadecimāls krāsas kods (piemēram, `FF0000`).
Noklusējums: `42A5F5`.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"|
|^|*Laika periods*|1|columns.0.sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - iestatīt dashboard [laika perioda atlasītāju](/manual/web_interface/time_period_selector) kā datu avotu;
`ABCDE._timeperiod` - iestatīt [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā `reference` parametru, kas vienāds ar `ABCDE`) kā datu avotu.
Noklusējums: `DASHBOARD._timeperiod`
Alternatīvi, laika periodu var iestatīt tikai parametros *No* un *Līdz*.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"|
|^|*No*|1|columns.0.sparkline.time_period.from|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` utt.).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"
- *obligāts*, ja ir iestatīts `columns.0.sparkline.time_period.to`|
|^|*Līdz*|1|columns.0.sparkline.time_period.to|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` utt.).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"
- *obligāts*, ja ir iestatīts `columns.0.sparkline.time_period.from`|
|^|*Vēstures dati*|0|columns.0.sparkline.history|0 - *(noklusējums)* Automātiski;
1 - Vēsture;
2 - Tendences.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Attēlojums* ir iestatīts uz "Sparkline"|
|*Sliekšņi*|<|<|<|<|
|<|*Krāsa*|1|columns.0.thresholds.0.color|Heksadecimāls krāsas kods (piemēram, `FF0000`).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski"|
|^|*Slieksnis*|1|columns.0.thresholds.0.threshold|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G").
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski"|
|*Izcēlumi*|<|<|<|<|
|<|*Izcēlums*|1|columns.0.highlights.0.color|Heksadecimāls krāsas kods (piemēram, `FF0000`).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Teksts"|
|^|*Slieksnis*|1|columns.0.highlights.0.pattern|Jebkura regulārā izteiksme.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Teksts"|
|*Decimālzīmju skaits*|<|0|columns.0.decimal_places|Iespējamās vērtības ir diapazonā no 0 līdz 10.
Noklusējums: 2.|
|***Paplašinātā konfigurācija***|<|<|<|<|
|*Agregācijas funkcija*|<|0|columns.0.aggregate_function|Ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski":
0 - *(noklusējums)* netiek izmantota;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Ja *Rādīt vērtību kā* ir iestatīts uz "Teksts":
0 - *(noklusējums)* netiek izmantota;
4 - count;
6 - first;
7 - last.|
|*Laika periods*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - iestatīt dashboard [laika perioda atlasītāju](/manual/web_interface/time_period_selector) kā datu avotu;
`ABCDE._timeperiod` - iestatīt [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā `reference` parametru, kas vienāds ar `ABCDE`) kā datu avotu.
Noklusējums: `DASHBOARD._timeperiod`
Alternatīvi, laika periodu var iestatīt tikai parametros *No* un *Līdz*.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Agregācijas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"|
|<|*No*|1|columns.0.time_period.from|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` utt.).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Laika periods* nav iestatīts un *Agregācijas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"
- *obligāts*, ja ir iestatīts `columns.0.time_period.to`|
|^|*Līdz*|1|columns.0.time_period.to|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` utt.).
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Laika periods* nav iestatīts un *Agregācijas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"
- *obligāts*, ja ir iestatīts `columns.0.time_period.from`|
|*Vēstures dati*|<|0|columns.0.history|0 - *(noklusējums)* Automātiski;
1 - Vēsture;
2 - Tendences.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski"|
|*Agregēt*|<|0|columns.0.aggregate_columns|0 - *(noklusējums)* Katrs vienums atsevišķi
1 - Apvienoti.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Rādīt vērtību kā* ir iestatīts uz "Skaitliski" un *Attēlojums* ir iestatīts uz "Kā ir", "Josla" vai "Indikatori".|
|*Apvienotā agregācijas funkcija*|<|0|columns.0.column_aggregate_function|1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum *(noklusējums)*.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurēts *Agregēt*.|
|*Apvienotās kolonnas nosaukums*|<|1|columns.0.combined_column_name|Jebkura virknes vērtība.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja tiek konfigurēts *Agregēt*.|
[comment]: # ({/e913fe7b-f35f175e})
[comment]: # ({d54c360f-0700aebf})
### Piemēri
Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Top items* logrīkam.
Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/d54c360f-0700aebf})
[comment]: # ({0ecc438c-03c7c01f})
#### *Top items* logrīka konfigurēšana
Konfigurējiet *Top items* logrīku, kas attēlo datus hostam "10084" un tikai tiem vienumiem, kuriem tags ar nosaukumu "component" satur vērtību "cpu".
Papildus attēlojiet datus ar hostiem augšpusē un šūnu attēlošanai izmantojiet krāsainu mērinstrumenta joslu.
[Pieprasījums](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "topitems",
"name": "Top items",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "columns.0.items.0",
"value": "*"
},
{
"type": 1,
"name": "columns.0.item_tags.0.tag",
"value": "component"
},
{
"type": 0,
"name": "columns.0.item_tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "columns.0.item_tags.0.value",
"value": "cpu"
},
{
"type": 0,
"name": "columns.0.display",
"value": 2
},
{
"type": 0,
"name": "layout",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Atbilde:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/0ecc438c-03c7c01f})
[comment]: # ({e9d30322-2b7384bb})
### Skatiet arī
- [Informācijas paneļa logrīka lauks](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-2b7384bb})