[comment]: # translation:outdated
[comment]: # ({95e690e3-978cbb20})
# 26 Top hosts
[comment]: # ({/95e690e3-978cbb20})
[comment]: # ({55ebe2fe-c5138763})
### Beschrijving
Deze parameters en de mogelijke eigenschapswaarden voor de respectievelijke objecten van veldwidgets van het dashboard stellen je in staat om de [*Top Hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) widget te configureren in de `dashboard.create` en `dashboard.update` methoden.
[comment]: # ({/55ebe2fe-c5138763})
[comment]: # ({e4c8dace-a3febace})
### Parameters
De volgende parameters worden ondersteund voor de *Top hosts* widget.
|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Vernieuwingsinterval*|<|0|rf_rate|0 - Geen vernieuwing;
10 - 10 seconden;
30 - 30 seconden;
60 - *(standaard)* 1 minuut;
120 - 2 minuten;
600 - 10 minuten;
900 - 15 minuten.|
|*Hostgroepen*|<|2|groupids|[Hostgroep](/manual/api/reference/hostgroup/get) ID.
Opmerking: Om meerdere hostgroepen te configureren, maak voor elke hostgroep een veldobject voor het dashboard-widget.|
|*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.
Opmerking: Om meerdere hosts te configureren, maak voor elke host een veldobject voor het dashboard-widget. Voor meerdere hosts moet de parameter *Hostgroepen* ofwel helemaal niet geconfigureerd zijn, of geconfigureerd zijn met ten minste één hostgroep waartoe de geconfigureerde hosts behoren.|
|*Host-tags* (het getal in de eigenschapsnaam (bijv. tags.tag.0) verwijst naar de tagvolgorde in de tag-evaluatielijst)|<|<|<|<|
|<|*Evaluatietype*|0|evaltype|0 - *(standaard)* En/Of;
2 - Of.|
|^|*Tagnaam*|1|tags.tag.0|Elke tekenreekswaarde.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *vereist* als *Tags* geconfigureerd zijn|
|^|*Operator*|0|tags.operator.0|0 - Bevat;
1 - Is gelijk aan;
2 - Bevat niet;
3 - Is niet gelijk aan;
4 - Bestaat;
5 - Bestaat niet.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *vereist* als *Tags* geconfigureerd zijn|
|^|*Tagwaarde*|1|tags.value.0|Elke tekenreekswaarde.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *vereist* als *Tags* geconfigureerd zijn|
|*Kolommen* (zie hieronder)|<|<|<|<|
|*Volgorde*|<|0|order|2 - *(standaard)* Top N;
3 - Onderste N.|
|*Kolom voor volgorde*|<|0|column|Kolom numerieke waarde van de geconfigureerde kolommen.|
|*Aantal hosts*|<|0|count|Geldige waarden variëren van 1-100.
Standaard: 10.|
[comment]: # ({/e4c8dace-a3febace})
[comment]: # ({a7c18e2b-8266fc04})
#### Kolommen
Kolommen hebben algemene parameters en aanvullende parameters afhankelijk van de configuratie van de parameter *Data*.
::: noteclassic
Voor alle parameters die verband houden met kolommen verwijst het getal in de eigenschapsnaam (bijv. columns.name.0) naar een kolom waarvoor de parameter is geconfigureerd.
:::
[comment]: # ({/a7c18e2b-8266fc04})
[comment]: # ({fc9d3dde-bba2be85})
De volgende parameters worden ondersteund voor alle kolommen.
|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Name*|1|columns.name.0|Elke tekenreekswaarde.|
|*Data*|0|columns.data.0|1 - Itemwaarde;
2 - Hostnaam;
3 - Tekst.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *verplicht*|
|*Base color*|1|columns.base_color.0|Hexadecimale kleurcode (bijv. `FF0000`).
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *verplicht*|
[comment]: # ({/fc9d3dde-bba2be85})
[comment]: # ({1bc7dbc9-e8b395eb})
##### Itemwaarde
De volgende parameters worden ondersteund als *Data* is ingesteld op "Itemwaarde".
::: noteclassic
Het eerste nummer in de naam van de eigenschap *Thresholds* (bijv. columnsthresholds.color.0.0) verwijst naar de kolom waarvoor drempelwaarden zijn geconfigureerd,
terwijl het tweede nummer verwijst naar de drempelplaats in een lijst, gesorteerd in oplopende volgorde.
Als de drempelwaarden echter in een andere volgorde zijn geconfigureerd, worden de waarden oplopend gesorteerd nadat de widgetconfiguratie is bijgewerkt in de Zabbix-frontend
(bijv. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`).
:::
|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Item*|<|1|columns.item.0|Geldige itemnaam.|
|*Time shift*|<|1|columns.timeshift.0|Geldige numerieke of tijdsreekswaarde (bijv. `3600` of `1u`).
U kunt [tijdsuffixen](/manual/appendix/suffixes#time-suffixes) gebruiken. Negatieve waarden zijn toegestaan.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *vereist*|
|*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(standaard)* geen;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.|
|*Aggregation interval*|<|1|columns.aggregate_interval.0|Geldige tijdsreekswaarde (bijv. `3600`, `1u`, enz.).
U kunt [tijdsuffixen](/manual/appendix/suffixes#time-suffixes) gebruiken.
Parameter *Aggregation interval* niet beschikbaar als *Aggregation function* is ingesteld op *geen*.
Standaard: `1u`.|
|*Weergave*|<|0|columns.display.0|1 - *(standaard)* Zoals het is;
2 - Staaf;
3 - Indicatoren.|
|*Min*|<|1|columns.min.0|Elke numerieke waarde.
Parameter *Min* niet beschikbaar als *Weergave* is ingesteld op "Zoals het is".|
|*Max*|<|1|columns.max.0|Elke numerieke waarde.
Parameter *Max* niet beschikbaar als *Weergave* is ingesteld op "Zoals het is".|
|*Decimal places*|<|0|columns.decimal_places.0|Geldige waarden variëren van 0-10.
Standaard: 2.|
|*Historische gegevens*|<|0|columns.history.0|1 - *(standaard)* Automatisch;
2 - Geschiedenis;
3 - Trends.|
|*Drempelwaarden*|<|<|<|<|
|<|*Kleur*|1|columnsthresholds.color.0.0|Hexadecimale kleurcode (bijv. `FF0000`).
Standaard: `""` (leeg).|
|^|*Drempel*|1|columnsthresholds.threshold.0.0|Elke tekenreekswaarde.|
[comment]: # ({/1bc7dbc9-e8b395eb})
[comment]: # ({cac487a9-18fd738d})
##### Tekst
De volgende parameters worden ondersteund als *Data* is ingesteld op "Tekst".
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Tekst*|1|columns.text.0|Een willekeurige tekenreekswaarde, inclusief macro's.
Ondersteunde macro's: {HOST.\*}, {INVENTORY.\*}.
[Gedrag van de parameter](/manual/api/reference_commentary#parameter-behavior):
- *vereist* als *Data* is ingesteld op "Tekst"|
[comment]: # ({/cac487a9-18fd738d})
[comment]: # ({e7eaa526-c274247c})
### Voorbeelden
De volgende voorbeelden hebben als doel enkel de configuratie te beschrijven van de veldobjecten van het dashboardwidget voor de *Top hosts* widget.
Voor meer informatie over het configureren van een dashboard, zie [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/e7eaa526-c274247c})
[comment]: # ({c09e6028-2e9b79c3})
#### Configuratie van een *Top hosts* widget
Configureer een *Top hosts* widget die de top hosts weergeeft op basis van CPU-gebruik in hostgroep "4".
Daarnaast, configureer de volgende aangepaste kolommen: "Hostnaam", "CPU-gebruik in %", "1m gem.", "5m gem.", "15m gem.", "Processen".
[Aanvraag](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mijn dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids",
"value": 4
},
{
"type": 1,
"name": "columns.name.0",
"value": ""
},
{
"type": 0,
"name": "columns.data.0",
"value": 2
},
{
"type": 1,
"name": "columns.base_color.0",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.item.0",
"value": "Systeemnaam"
},
{
"type": 1,
"name": "columns.timeshift.0",
"value": ""
},
{
"type": 1,
"name": "columns.name.1",
"value": "CPU-gebruik in %"
},
{
"type": 0,
"name": "columns.data.1",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.1",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.item.1",
"value": "CPU-gebruik"
},
{
"type": 1,
"name": "columns.timeshift.1",
"value": ""
},
{
"type": 0,
"name": "columns.display.1",
"value": 3
},
{
"type": 1,
"name": "columns.min.1",
"value": "0"
},
{
"type": 1,
"name": "columns.max.1",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.color.1.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.color.1.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.color.1.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.2",
"value": "90"
},
{
"type": 1,
"name": "columns.name.2",
"value": "1m gem."
},
{
"type": 0,
"name": "columns.data.2",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.2",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.item.2",
"value": "Gemiddelde belasting (1m gem.)"
},
{
"type": 1,
"name": "columns.timeshift.2",
"value": ""
},
{
"type": 1,
"name": "columns.name.3",
"value": "5m gem."
},
{
"type": 0,
"name": "columns.data.3",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.3",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.item.3",
"value": "Gemiddelde belasting (5m gem.)"
},
{
"type": 1,
"name": "columns.timeshift.3",
"value": ""
},
{
"type": 1,
"name": "columns.name.4",
"value": "15m gem."
},
{
"type": 0,
"name": "columns.data.4",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.4",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.item.4",
"value": "Gemiddelde belasting (15m gem.)"
},
{
"type": 1,
"name": "columns.timeshift.4",
"value": ""
},
{
"type": 1,
"name": "columns.name.5",
"value": "Processen"
},
{
"type": 0,
"name": "columns.data.5",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.5",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.item.5",
"value": "Aantal processen"
},
{
"type": 1,
"name": "columns.timeshift.5",
"value": ""
},
{
"type": 0,
"name": "columns.decimal_places.5",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Reactie:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/c09e6028-2e9b79c3})
[comment]: # ({e9d30322-d8c32fe2})
### Zie ook
- [Dashboard widgetveld](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-d8c32fe2})