[comment]: # translation:outdated

[comment]: # ({167707a1-6d33dfbd})
# 8 Grafiek

[comment]: # ({/167707a1-6d33dfbd})

[comment]: # ({51f55564-5c2abed1})
### Beschrijving

Deze parameters en de mogelijke eigenschapswaarden voor de respectieve dashboard-widgetveldobjecten stellen in staat om de [*Grafiek*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) widget te configureren in de `dashboard.create` en `dashboard.update` methoden.

[comment]: # ({/51f55564-5c2abed1})

[comment]: # ({86c426f8-75d80010})
### Parameters

De volgende parameters worden ondersteund voor de *Grafiek* widget.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-----|-|-----|-------------------|
|*Vernieuwingsinterval*|0|rf_rate|0 - Geen vernieuwing;<br>10 - 10 seconden;<br>30 - 30 seconden;<br>60 - *(standaard)* 1 minuut;<br>120 - 2 minuten;<br>600 - 10 minuten;<br>900 - 15 minuten.|

[comment]: # ({/86c426f8-75d80010})

[comment]: # ({59cea80f-9cf31911})
#### Gegevensset

De volgende parameters worden ondersteund voor het configureren van een *Gegevensset*.

::: noteclassic
Het eerste getal in de eigenschapsnaam (bijv. ds.hosts.0.0, ds.items.0.0) vertegenwoordigt de specifieke gegevensset,
terwijl het tweede getal, indien aanwezig, het geconfigureerde host of item vertegenwoordigt.
:::

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-|--------|--|--------|-------------------------------|
|*Type gegevensset*|<|0|ds.dataset_type.0|0 - Itemlijst;<br>1 - *(standaard)* Itempatroon.|
|Parameters als *Type gegevensset* is ingesteld op "Itemlijst"|<|<|<|<|
|<|*Items*|4|ds.itemids.0.0|[Item](/manual/api/reference/item/get) ID.<br><br>Opmerking: Om meerdere items te configureren, maak voor elk item een dashboard-widgetveldobject aan.<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|^|*Kleur*|1|ds.color.0.0|Hexadecimale kleurcode (bijv. `FF0000`).<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|Parameters als *Type gegevensset* is ingesteld op "Itempatroon"|<|<|<|<|
|<|*Hostpatroon*|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) naam of patroon (bijv., "Zabbix\*").<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|^|*Itempatroon*|1|ds.items.0.0|[Item](/manual/api/reference/item/get) naam of patroon (bijv., "\*: Aantal verwerkte \*waarden per seconde").<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|^|*Kleur*|1|ds.color.0|Hexadecimale kleurcode (bijv. `FF0000`).<br><br>Standaard: `FF465C`.|
|*Teken*|<|0|ds.type.0|0 - *(standaard)* Lijn;<br>1 - Punten;<br>2 - Trapsgewijs;<br>3 - Staaf.|
|*Gestapeld*|<|0|ds.stacked.0|0 - *Uitgeschakeld*;<br>1 - Ingeschakeld.<br><br>Parameter *Gestapeld* niet beschikbaar als *Teken* is ingesteld op "Punten".|
|*Breedte*|<|0|ds.width.0|Geldige waarden variëren van 1-10.<br><br>Standaard: 1.<br><br>Parameter *Breedte* niet beschikbaar als *Teken* is ingesteld op "Punten" of "Staaf".|
|*Puntgrootte*|<|0|ds.pointsize.0|Geldige waarden variëren van 1-10.<br><br>Standaard: 3.<br><br>Parameter *Puntgrootte* niet beschikbaar als *Teken* is ingesteld op "Lijn", "Trapsgewijs" of "Staaf".|
|*Transparantie*|<|0|ds.transparency.0|Geldige waarden variëren van 1-10.<br><br>Standaard: 5.|
|*Vullen*|<|0|ds.fill.0|Geldige waarden variëren van 1-10.<br><br>Standaard: 3.<br><br>Parameter *Vullen* niet beschikbaar als *Teken* is ingesteld op "Punten" of "Staaf".|
|*Ontbrekende gegevens*|<|0|ds.missingdatafunc.0|0 - *Geen*;<br>1 - Verbonden;<br>2 - Beschouw als 0;<br>3 - Laatst bekend.<br><br>Parameter *Ontbrekende gegevens* niet beschikbaar als *Teken* is ingesteld op "Punten" of "Staaf".|
|*Y-as*|<|0|ds.axisy.0|0 - *(standaard)* Links;<br>1 - Rechts.|
|*Tijdsverschuiving*|<|1|ds.timeshift.0|Geldige tijdnotatie (bijv. `3600`, `1u`, enz.).<br>Je kunt [tijdsuffixen](/manual/appendix/suffixes#time-suffixes) gebruiken. Negatieve waarden zijn ook toegestaan.<br><br>Standaard: `""` (leeg).|
|*Aggregatiefunctie*|<|0|ds.aggregate_function.0|0 - *(standaard)* geen;<br>1 - min;<br>2 - max;<br>3 - gem;<br>4 - tel;<br>5 - som;<br>6 - eerst;<br>7 - laatst.|
|*Aggregatie-interval*|<|1|ds.aggregate_interval.0|Geldige tijdnotatie (bijv. `3600`, `1u`, enz.).<br>Je kunt [tijdsuffixen](/manual/appendix/suffixes#time-suffixes) gebruiken.<br><br>Standaard: `1u`.|
|*Agrégat*|<|0|ds.aggregate_grouping.0|0 - *Elk item*;<br>1 - Gegevensset.<br><br>Parameter *Agrégat* niet beschikbaar als *Aggregatiefunctie* is ingesteld op "geen".|
|*Benadering*|<|0|ds.approximation.0|1 - min;<br>2 - *(standaard)* gem;<br>4 - max;<br>7 - allemaal.|
|*Label gegevensset*|<|1|ds.data_set_label.0|Elke tekenreekswaarde.<br><br>Standaard: `""` (leeg).|

[comment]: # ({/59cea80f-9cf31911})

[comment]: # ({1114c542-1e2d4083})
#### Weergaveopties

De volgende parameters worden ondersteund voor het configureren van *Weergaveopties*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-|--------|--|--------|-------------------------------|
|*Selectie historische gegevens*|<|0|source|0 - *(standaard)* Automatisch;<br>1 - Geschiedenis;<br>2 - Trends.|
|*Eenvoudige triggers*|<|0|simple_triggers|0 - *Uitgeschakeld*;<br>1 - Ingeschakeld.|
|*Werkuren*|<|0|working_time|0 - *Uitgeschakeld*;<br>1 - Ingeschakeld.|
|*Percentiellijn (links)* (parameter beschikbaar als *Y-as* (in *Gegevensset* configuratie) is ingesteld op "Links")|<|<|<|<|
|<|*Status*|0|percentile_left|0 - *(standaard)* Uitgeschakeld;<br>1 - Ingeschakeld.|
|^|*Waarde*|0|percentile_left_value|Geldige waarden variëren van 1-100.|
|*Percentiellijn (rechts)* (parameter beschikbaar als *Y-as* (in *Gegevensset* configuratie) is ingesteld op "Rechts")|<|<|<|<|
|<|*Status*|0|percentile_right|0 - *(standaard)* Uitgeschakeld;<br>1 - Ingeschakeld.|
|^|*Waarde*|0|percentile_right_value|Geldige waarden variëren van 1-100.|

[comment]: # ({/1114c542-1e2d4083})

[comment]: # ({36354072-2fc4e743})
#### Tijdsperiode

De volgende parameters worden ondersteund voor het configureren van de *Tijdsperiode*.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-----|-|-----|-------------------|
|*Stel aangepaste tijdsperiode in*|0|graph_time|0 - *Uitgeschakeld*;<br>1 - Ingeschakeld.|
|*Van*|1|time_from|Geldige tijdnotatie in het formaat `YYYY-MM-DD uu:mm:ss`.<br>[Relatieve tijdsperiode](/manual/config/visualization/graphs/simple#time-period-selector) waarden (`now`, `now/d`, `now/w-1w`, enz.) worden ook ondersteund.<br><br>Standaard: `now-1u`.|
|*Tot*|1|time_to|Geldige tijdnotatie in het formaat `YYYY-MM-DD uu:mm:ss`.<br>[Relatieve tijdsperiode](/manual/config/visualization/graphs/simple#time-period-selector) waarden (`now`, `now/d`, `now/w-1w`, enz.) worden ook ondersteund.<br><br>Standaard: `now`.|

[comment]: # ({/36354072-2fc4e743})

[comment]: # ({a0674fde-bca60ab8})
#### Assen

De volgende parameters worden ondersteund voor het configureren van *Assen*.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-----|-|-----|-------------------|
|*Linker Y*|0|lefty|0 - Uitgeschakeld;<br>1 - *(standaard)* Ingeschakeld.<br><br>Parameter beschikbaar als *Y-as* (in *Gegevensset* configuratie) is ingesteld op "Links".|
|*Rechter Y*|0|righty|0 - *(standaard)* Uitgeschakeld;<br>1 - Ingeschakeld.<br><br>Parameter beschikbaar als *Y-as* (in *Gegevensset* configuratie) is ingesteld op "Rechts".|
|*Min*|1|lefty_min|Een numerieke waarde.<br><br>Standaard: `""` (leeg).|
|^|^|righty_min|^|
|*Max*|1|lefty_max|Een numerieke waarde.<br><br>Standaard: `""` (leeg).|
|^|^|righty_max|^|
|*Eenheden* (type)|0|lefty_units|0 - *(standaard)* Automatisch;<br>1 - Statisch.|
|^|^|righty_units|^|
|*Eenheden* (waarde)|1|lefty_static_units|Een willekeurige tekenreekswaarde.<br><br>Standaard: `""` (leeg).|
|^|^|righty_static_units|^|
|*X-as*|0|xaxis|0 - Uitgeschakeld;<br>1 - *(standaard)* Ingeschakeld.|

[comment]: # ({/a0674fde-bca60ab8})

[comment]: # ({5048810c-09de7a04})
#### Legenda

De volgende parameters worden ondersteund voor het configureren van de *Legenda*.

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-----|-|-----|-------------------|
|*Toon legenda*|0|legend|0 - Uitgeschakeld;<br>1 - *(standaard)* Ingeschakeld.|
|*Toon min/max/gem*|0|legend_statistic|0 - *(standaard)* Uitgeschakeld;<br>1 - Ingeschakeld.|
|*Aantal rijen*|0|legend_lines|Geldige waarden variëren van 1-10.<br><br>Standaard: 1.|
|*Aantal kolommen*|0|legend_columns|Geldige waarden variëren van 1-4.<br><br>Standaard: 4.|

[comment]: # ({/5048810c-09de7a04})

[comment]: # ({55651c5b-82002e68})
#### Problemen

De volgende parameters worden ondersteund voor het configureren van *Problemen*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-|--------|--|--------|-------------------------------|
|*Toon problemen*|<|0|show_problems|0 - *(standaard)* Uitgeschakeld;<br>1 - Ingeschakeld.|
|*Alleen geselecteerde items*|<|0|graph_item_problems|0 - Uitgeschakeld;<br>1 - *(standaard)* Ingeschakeld.|
|*Probleemhosts*|<|1|problemhosts.0|Naam van de [host](/manual/api/reference/host/get).<br><br>Opmerking: Het getal in de eigenschapsnaam verwijst naar de geconfigureerde host.<br>Om meerdere hosts te configureren, maak een dashboard widget field object aan voor elke host.|
|*Zwaarte*|<|0|severities|0 - Niet geclassificeerd;<br>1 - Informatie;<br>2 - Waarschuwing;<br>3 - Gemiddeld;<br>4 - Hoog;<br>5 - Ramp.<br><br>Standaard: 1, 2, 3, 4, 5 (allemaal ingeschakeld).<br><br>Opmerking: Om meerdere waarden te configureren, maak een dashboard widget field object aan voor elke waarde.|
|*Probleem*|<|1|problem_name|Probleem [gebeurtenisnaam](/manual/config/triggers/trigger#configuration) (hoofdletteronafhankelijk, volledige naam of een deel ervan).|
|*Tags* (het getal in de eigenschapsnaam (bijv. tags.tag.0) verwijst naar de volgorde van de tagevaluatielijst)|<|<|<|<|
|<|*Evaluatietype*|0|evaltype|0 - *(standaard)* En/Of;<br>2 - Of.|
|^|*Tag-naam*|1|tags.tag.0|Willekeurige tekenreekswaarde.<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist* als je *Tags* configureert|
|^|*Operator*|0|tags.operator.0|0 - Bevat;<br>1 - Is gelijk aan;<br>2 - Bevat niet;<br>3 - Is niet gelijk aan;<br>4 - Bestaat;<br>5 - Bestaat niet.<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist* als je *Tags* configureert|
|^|*Tag-waarde*|1|tags.value.0|Willekeurige tekenreekswaarde.<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist* als je *Tags* configureert|

[comment]: # ({/55651c5b-82002e68})

[comment]: # ({b69e3838-4097ae32})
#### Overschrijvingen

De volgende parameters worden ondersteund voor het configureren van *Overschrijvingen*.

::: noteclassic
Het eerste nummer in de eigenschapsnaam (bijv. or.hosts.0.0, or.items.0.0) vertegenwoordigt de specifieke dataset,
terwijl het tweede nummer, indien aanwezig, de geconfigureerde host of het item vertegenwoordigt.
:::

|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|naam|waarde|
|-----|-|-----|-------------------|
|*Hostpatroon*|1|or.hosts.0.0|Naam of patroon van de [host](/manual/api/reference/host/get) (bijv. `Zabbix*`).<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|*Itempatroon*|1|or.items.0.0|Naam of patroon van het [item](/manual/api/reference/item/get) (bijv. `*: Aantal verwerkte *waarden per seconde`).<br><br>[Parametergedrag](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist*|
|*Basis kleur*|1|or.color.0|Hexadecimale kleurcode (bijv. `FF0000`).|
|*Breedte*|0|or.width.0|Geldige waarden variëren van 1-10.|
|*Teken*|0|or.type.0|0 - Lijn;<br>1 - Punten;<br>2 - Trapsgewijs;<br>3 - Staaf.|
|*Transparantie*|0|or.transparency.0|Geldige waarden variëren van 1-10.|
|*Vullen*|0|or.fill.0|Geldige waarden variëren van 1-10.|
|*Puntgrootte*|0|or.pointsize.0|Geldige waarden variëren van 1-10.|
|*Ontbrekende gegevens*|0|or.missingdatafunc.0|0 - Geen;<br>1 - Verbonden;<br>2 - Behandel als 0;<br>3 - Laatst bekend.|
|*Y-as*|0|or.axisy.0|0 - Links;<br>1 - Rechts.|
|*Tijdverschuiving*|1|or.timeshift.0|Geldige tijdsnotatie (bijv. `3600`, `1u`, enz.).<br>Je kunt [tijdsuffixen](/manual/appendix/suffixes#time-suffixes) gebruiken. Negatieve waarden zijn toegestaan.|

[comment]: # ({/b69e3838-4097ae32})

[comment]: # ({0d773487-5887cb51})
### Voorbeelden

De volgende voorbeelden hebben alleen betrekking op de configuratie van de dashboard-widgetveldobjecten voor de *Grafiek* widget.
Voor meer informatie over het configureren van een dashboard, zie [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/0d773487-5887cb51})

[comment]: # ({9f956f09-102e83b4})
#### Configuratie van een *Grafiek* widget

Configureer een *Grafiek* widget op de volgende manier:

-   2 datasets voor in totaal 9 items op 1 host.
-   De eerste dataset is van het type "Itemlijst" en bestaat uit 3 items die worden weergegeven als lijnen met verschillende kleuren, maar dezelfde breedte, transparantie en vulling.
-   De tweede dataset is van het type "Itempatroon", bestaat uit 6 items, heeft een geconfigureerde aggregatie en wordt weergegeven als een lijn met een aangepaste kleur, breedte, transparantie en vulling.
-   De tweede dataset heeft ook een aangepast datasetlabel.
-   Gegevens in de grafiek worden weergegeven voor een tijdsperiode van de laatste 3 uur.
-   Problemen in de grafiek worden alleen weergegeven voor de geconfigureerde items.
-   De grafiek heeft twee Y-assen waarvan de rechter Y-as waarden weergeeft alleen voor de tweede dataset.
-   De legenda van de grafiek toont geconfigureerde items in 4 rijen, evenals minimale, maximale en gemiddelde waarden van de datasets.

[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": "svggraph",
                        "name": "Grafiek",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "ds.dataset_type.0",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.1",
                                "value": 23264
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.1",
                                "value": "FF0000"
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.2",
                                "value": 23269
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.2",
                                "value": "BF00FF"
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.3",
                                "value": 23257
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.3",
                                "value": "0040FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.width.0",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.0",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.0",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.hosts.1.0",
                                "value": "Zabbix-server"
                            },
                            {
                                "type": 1,
                                "name": "ds.items.1.0",
                                "value": "*: Aantal verwerkte *waarden per seconde"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.1",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.1",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.1",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.axisy.1",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_function.1",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.aggregate_interval.1",
                                "value": "1m"
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_grouping.1",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.data_set_label.1",
                                "value": "Aantal verwerkte waarden per seconde"
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_from",
                                "value": "now-3h"
                            },
                            {
                                "type": 0,
                                "name": "legend_statistic",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "show_problems",
                                "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]: # ({/9f956f09-102e83b4})

[comment]: # ({e9d30322-3c27dd53})
Zie ook:

- [Dashboard widget veld](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-3c27dd53})