9 Граф

Опис

Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање виџета Graph у методама dashboard.create и dashboard.update.

Параметери

Следећи параметри су подржани за виџет Graph.

Скуп података

Следећи параметри су подржани за конфигурисање Скупа података.

|^|Item patterns|1|ds.0.items.0|Item назив или шаблон (нпр., "*: Број обрађених *вредности по секунди").

Када конфигуришете виџет на template dashboard, треба да се подесе само шаблони за ставке конфигурисане на шаблону.

[Parameter behavior) (/manual/api/reference_commentary#parameter-behavior):
- обавезно ако је Тип скупа података постављен на "Шаблони ставке"| |^|Color|1|ds.0.color|Хексадецимални код боје (нпр., FF0000).

Подразумевано: FF465C.

Parameter behavior:
- подржано ako је Тип скупа података постављен на "Шаблон ставки"| |Цртање|<|0|ds.0.type|0 - (подразумевано) Линија;
1 - Тачке;
2 - Степенасти графикон;
3 - Стубићи.| |Stacked|<|0|ds.0.stacked|0 - (подразумевано) Онемогућено;
1 - Омогућено.

Parameter behavior:
- подржано ако је Цртање постављено на "Линија", "Степенасти графикон" или "Стубићи"| |Width|<|0|ds.0.width|Могуће вредности се крећу од 1-10.

Подразумевано: 1.

Parameter behavior:
- подржано ако је Цртање постављено на "Линија" или "Степенасти графикон"| |Point size|<|0|ds.0.pointsize|Могуће вредности се крећу од 1-10.

Подразумевано: 3.

Parameter behavior:
- supported ако је Цртање постављено на "Тачке"| |Transparency|<|0|ds.0.transparency|Могуће вредности се крећу од 1-10.

Подразумевано: 5.| |Fill|<|0|ds.0.fill|Могуће вредности се крећу од 1 до 10.

Подразумевано: 3.

Parameter behavior:
- подразумевано ако је Цртање постављено на "Линија" или "Степенасти графикон"| |Missing data|<|0|ds.0.missingdatafunc|0 - (подразумевано) Нема;
1 - Повезано;
2 - Третирај као 0;
3 - Последња позната вредност.

Parameter behavior:
- подржано ако је Draw постављено на "Линија" или "Степенасти графикон"| |Y-axis|<|0|ds.0.axisy|0 - (подразумевано) Лево;
1 - Десно.| |Time shift|<|1|ds.0.timeshift|Валидан временски низ (нпр., 3600, 1h, итд.).
Можете користити time suffixes. Негативне вредности су такође дозвољене.

Подразумевано: "" (празно).| |Aggregation function|<|0|ds.0.aggregate_function|0 - (подразумевано) није коришћено;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.| |Aggregation interval|<|1|ds.0.aggregate_interval|Валидан временски низ (нпр., 3600, 1h, итд.).
Можете користити time suffixes.

Подразумевано: 1h.| |Aggregate|<|0|ds.0.aggregate_grouping|0 - (подразумевано) Свака ставка;
1 - Скуп података.

Parameter behavior:
- подржано ако је Функција агрегације постављена на "min", "max", "avg", "count", "sum", "first", или "last"| |Approximation|<|0|ds.0.approximation|1 - min;
2 - (default) avg;
4 - max;
7 - all.| |Data set label|<|1|ds.0.data_set_label|Било која вредност стринга.

Подразумевано: "" (празно).|

Опције приказа

Следећи параметри су подржани за конфигурисање Опције приказа.

|Parameter|<|type|name|value| |-|--------|--|--------------------------------- -----| |History data selection|<|0|source|0 - (подразумевано) Ауто;
1 - Историја;
2 - Трендови.| |Simple triggers|<|0|simple_triggers|0 - (подразумевано) Онемогућено;
1 - Омогућено.| |Working time|<|0|working_time|0 - (подразумевано) Онемогућено;
1 - Омогућено.| |Percentile line (left)|<|<|<|<| |<|Status|0|percentile_left|0 - (подразумевано) Онемогућено;
1 - Омогућено.

Parameter behavior:
- подржано ако је Y-оца (у Data set конфигурацији) постављена на "Лево"| |^|Value|0|percentile_left_value|Могуће вредности су у распону од 1-100.

Parameter behavior:
- подржано ако је Y-оса (у Data set конфигурацији) постављена на "Лево"| |Percentile line (right)|<|<|<|<| |<|Status|0|percentile_right|0 - (подразумевано) Онемогућено;
1 - Омогућено.

Parameter behavior:
- подржано ако је Y-оса (у Data set конфигурацији) постављена на "Десно"| |^|Value|0|percentile_right_value|Могуће вредности су у распону од 1-100.

Parameter behavior:
- подржано ако је Y-оса (у Data set конфигурацији) постављена на "Десно"|

Временски период

Следећи параметри су подржани за конфигурисање Временског периода.

|Parameter|<|type|name|value| |-|--------|--|--------------------------------- -----| |Time period|<|1|time_period._reference|DASHBOARD._timeperiod- поставите Time period selector as the data source;
ABCDE._timeperiod- поставите compatible widget (са Reference параметром постављеним на "ABCDE") као извор података.

Подразумевано: DASHBOARD._timeperiod

Алтернативно, можете подесити временски период само у параметрима Од и До.| |<|From|1|time_period.from|Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).

Parameter behavior:
- подржано ако Временски период није подешен| |^|To|1|time_period.to|Важећи временски низ у апсолутној (YYYY-MM-DD hh:mm:ss) или relative временској синтакси (now, now/d, now/w-1w, итд.).

Parameter behavior:
- подржано ако Временски период није подешен|

Осe

Следећи параметри су подржани за конфигурисање Оса.

Легенда

Следећи параметри су подржани за конфигурисање Легенде.

Проблеми

Следећи параметри су подржани за конфигурисање Проблема.

|Parameter|<|type|name|value| |-|--------|--|--------------------------------- -----| |Show problems|<|0|show_problems
|0 - (подразумевано) Онемогућено;
1 - Омогућено.| |Selected items only|<|0|graph_item_problems|0 - Онемогућено;
1 - (подразумевано) Омогућено.| |Problem hosts|<|1|problemhosts.0|Host име.

Напомена: Број у имену својства упућује на конфигурисаног домаћина.
Да бисте конфигурисали више домаћина, креирајте објекат поља виџета контролне табле за сваког домаћина са увећаним бројем у називу својства.

Овај параметар није подржан ако конфигуришете виџет на template dashboard.| |Severity|<|0|severities.0|0 - Није класификовано;
1 - Информације;
2 - Упозорење;
3 - Просечно;
4 - Високо;
5 - Катастрофа.

Подразумевано: празно (све омогућено).

Напомена: Да бисте конфигурисали више вредности, креирајте објекат поља виџета контролне табле за сваку вредност са увећаним бројем у називу својства.| |Problem|<|1|problem_name|Проблем event name (не разликује велика и мала слова, пуно име или његов део).| |Problem tags|<|<|<|<| |<|Evaluation type|0|evaltype|0 - (подразумевано) И/Или;
2 - Или.| |^|Tag name|1|tags.0.tag|Било која вредност стринга.

Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.

Parameter behavior:
- обавезно ако се конфигуришу ознаке проблема| |^|Operator|0|tags.0.operator|0 – Садржи;
1 – Једнако;
2 – Не садржи;
3 – Није једнако;
4 – Постоји ;
5 – Не постоји.

Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.

Parameter behavior:
- обавезно ако се конфигуришу ознаке проблема| |^|Tag value|1|tags.0.value|Било која вредност стринга.

Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.

Parameter behavior:
- обавезно ако се конфигуришу ознаке проблема|

Overrides

Следећи параметри су подржани за конфигурисање Overrides.

::: noteclassic Први број у називу својства (нпр., or.0.hosts.0, or.0.items.0) представља одређени скуп података, док други број, ако постоји, представља конфигурисаног домаћина или ставку. :::

Примери

Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет Graph. За више информација о конфигурисању контролне табле погледајте dashboard.create.

Конфигурисање Graph виџета

Конфигуришите Graph виџета на следећи начин:

• 2 скупа података за укупно 9 ставки на 1 домаћину.
• Први скуп података је типа "Листа ставки" и састоји се од 3 ставке које су представљене линијама различитих боја, али исте ширине, провидности и попуњености.
• Други скуп података је типа "Шаблони ставки", састоји се од 6 ставки, има конфигурисану агрегацију и представљен је линијом са прилагођеном бојом, ширином, транспарентношћу и попуњеношћу.
• Други скуп података такође има прилагођену ознаку скупа података.
• Подаци на графикону се приказују за период од последња 3 сата.
• Проблеми на графикону су приказани само за конфигурисане ставке.
• Графикон има две Y-осе од којих десна Y-оса приказује вредности само за други скуп података.
• Легенда графикона приказује конфигурисане ставке у 4 реда, као и минималне, максималне и просечне вредности скупова података.

Request:

{
            "jsonrpc": "2.0",
            "method": "dashboard.create",
            "params": {
            "name": "My dashboard",
            "display_period": 30,
            "auto_start": 1,
            "pages": [
            {
            "widgets": [
            {
            "type": "svggraph",
            "name": "Graph",
            "x": 0,
            "y": 0,
            "width": 36,
            "height": 5,
            "view_mode": 0,
            "fields": [
            {
            "type": 0,
            "name": "ds.0.dataset_type",
            "value": 0
            },
            {
            "type": 4,
            "name": "ds.0.itemids.1",
            "value": 23264
            },
            {
           "type": 1,
            "name": "ds.0.color.1",
            "value": "FF0000"
            },
            {
            "type": 4,
            "name": "ds.0.itemids.2",
            "value": 23269
            },
            {
            "type": 1,
            "name": "ds.0.color.2",
            "value": "BF00FF"
            },
            {
            "type": 4,
            "name": "ds.0.itemids.3",
            "value": 23257
            },
            {
            "type": 1,
            "name": "ds.0.color.3",
            "value": "0040FF"
            },
            {
            "type": 0,
            "name": "ds.0.width",
            "value": 3
            },
            {
            "type": 0,
            "name": "ds.0.transparency",
            "value": 3
            },
            {
            "type": 0,
            "name": "ds.0.fill",
            "value": 1
            },
            {
            "type": 1,
            "name": "ds.1.hosts.0",
             "value": "Zabbix server"
            },
            {
            "type": 1,
            "name": "ds.1.items.0",
            "value": "*: Number of processed *values per second"
            },
            {
            "type": 1,
            "name": "ds.1.color",
            "value": "000000"
            },
            {
            "type": 0,
            "name": "ds.1.transparency",
            "value": 0
            },
            {
            "type": 0,
            "name": "ds.1.fill",
            "value": 0
            },
            {
            "type": 0,
            "name": "ds.1.axisy",
            "value": 1
            },
            {
            "type": 0,
            "name": "ds.1.aggregate_function",
            "value": 3
            },
            {
            "type": 1,
            "name": "ds.1.aggregate_interval",
            "value": "1m"
            },
            {
            "type": 0,
            "name": "ds.1.aggregate_grouping",
            "value": 1
            },
            {
            "type": 1,
            "name": "ds.1.data_set_label",
            "value": "Number of processed values per second"
            },
            {
            "type": 0,
            "name": "graph_time",
            "value": 1
            },
            {
            "type": 1,
            "name": "time_period.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
            },
            {
            "type": 1,
            "name": "reference",
            "value": "YZABC"
            }
            ]
            }
            ]
            }
            ],
            "userGroups": [
            {
            "usrgrpid": 7,
             "permission": 2
            }
            ],
            "users": [
            {
            "userid": 1,
            "permission": 3
            }
            ]
            },
            "id": 1
         }

Response:

 {
       
            "jsonrpc": "2.0",
            "result": {
            "dashboardids": [
            "3"
            ]
            },
            "id": 1
       }

Погледајте такође

• Dashboard widget field
• dashboard.create
• dashboard.update