8 Граф

Опис

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

Својства fields виџета се не проверавају током прављења или ажурирања контролне табле. Ово омогућава корисницима да модификују built-in widgets и креирају прилагођене виџете, али такође уводи ризик од неправилног креирања или ажурирања виџета. Да бисте осигурали успешно креирање или ажурирање виџета Графикон, погледајте понашање параметара наведено у табелама испод.

Параметери

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

Parameter type name value
Refresh interval 0 rf_rate 0 - Без освежавања;
10 - 10 секунди;
30 - 30 секунди;
60 - (подразумевано) 1 минут;
120 - 2 минута;
600 - 10 минута;
900 - 15 минута.
Reference 1 reference Било која вредност стринга од 5 карактера (нпр., ABCDE or JBPNL). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.

Parameter behavior:
- обавезно

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

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

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

Parameter type name value
Data set type 0 ds.0.dataset_type 0 - Листа података;
1 - (подразумевано) Шаблони ставке.
Items 4 ds.0.itemids.0 Ставка ID.

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

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

Понашање својства:
- обавезно ако је Тип скупа података подешен на "Листа ставки" и Ставке (Виџет) нису подешене
Items (Widget) 1 ds.0.itemids.0._reference Уместо Ставке ID:
ABCDE._itemid - подесите [компатибилни виџет] (/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са Референцом параметра подешеним на "ABCDE") као извор података за ставке.

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

Понашање својства:
- обавезно ако је Тип скупа података подешен на "Листа ставки" и Ставке нису подешене
Color 1 ds.0.color.0 Хексадецимални код боје (нпр., FF0000).

Понашање својства:
- обавезно ако је Data set type постављено на "Листа ставки"
Host patterns 1 ds.0.hosts.0 Домаћин назив или шаблон (нпр., "Zabbix*").

Понашање својства:
- обавезно ако је Тип скупа података постављен на "Шаблони ставке"

Овај параметар није подржан ако се виџет конфигурише на шаблон контролне табле.

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

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

Понашање својства:
- обавезно ако је Тип скупа података постављен на "Шаблони ставке"| |^|Color|1|ds.0.color|Хексадецимални код боје (нпр., FF0000).

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

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

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

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

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

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

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

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

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

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

Понашање својства:
- подржано ако је Draw постављено на "Линија" или "Степенасти графикон"| |Override host|<|1|ds.0.override_hostid._reference|ABCDE._hostid- поставља компатибилни виџет (са његовим параметром "Референца" постављеним на "ABCDE") као извор података за домаћине;
DASHBOARD._hostid - поставите селктор домаћина или извор података за домаћине.

Овај параметар није подржан ако се виџет конфигурише на шаблону контролне табле.| |Y-axis|<|0|ds.0.axisy|0 - (подразумевано) Лево;
1 - Десно.| |Time shift|<|1|ds.0.timeshift|Валидан временски низ (нпр., 3600, 1h, итд.).
Можете користити временски суфиксе. Негативне вредности су такође дозвољене.

Подразумевано: "" (празно).| |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, итд.).
Можете користити временски суфиксе.

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

Понашање својства:
- подржано ако је Функција агрегације постављена на "min", "max", "avg", "count", "sum", "first", или "last"| |Approximation|<|0|ds.0.approximation|1 - min;
2 - (подрашумевано) 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
Left Y 0 lefty 0 - Онемогућено;
1 - (подразумевано) Омогућено.

Понашање својства:
- подржано ако је Y-осаСкуп података конфигурацији) постављена на "Лево"
Right Y 0 righty 0 - (подразумевано) Онемогућено;
1 - Омогућено.

Понашање својства:
- подржано* ако је Y-осаСкуп података конфигурацији) постављена на "Десно"
Scale 0 lefty_scale 0 - (подразумевано) Линеарно;
1 - Логаритамски.
righty_scale
Min 1 lefty_min Било која нумеричка вредност.

Подразумевано: "" (празно).
righty_min
Max 1 lefty_max Било која нумеричка вредност.

Подразумевано: "" (празно).
righty_max
Units (type) 0 lefty_units 0 - (подразумевано) Аутоматски;
1 - Статично.
righty_units
Units (value) 1 lefty_static_units Било која вредност стринга.

Подразумевано: "" (празно).
righty_static_units
X-Axis 0 xaxis 0 - Онемогућено;
1 - (подразумевано) Омогућено.

Легенда

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

Parameter type name value
Show legend 0 legend 0 - Онемогућено;
1 - (подразумевано) Омогућено.

Parameter behavior:
- подржано ако је Прикажи легенду постављено на "Омогућено"
Display min/avg/max 0 legend_statistic 0 - (подразумевано) Онемогућено;
1 - Омогућено.

Parameter behavior:
- supported ако је Show legend постављено на "Омогућено"
Show aggregation function 0 legend_aggregation 0 - (подразумевано) Онемогућено;
1 - Омогућено.

Parameter behavior:
- подржано ако је Show legend постављено на "Омогућено"
Rows 0 legend_lines_mode 0 - (подразумевано) Фиксно;
1 - Променљиво.

Parameter behavior:
- подржано ако је Прикажи легенду постављено на "Омогућено"
Number of rows/
Maximum number of rows
0 legend_lines Могуће вредности се крећу од 1-10.

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

Parameter behavior:
- подржано ако је Show legend постављено на "Омогућено"
Number of columns 0 legend_columns Могуће вредности се крећу од 1-4.

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

Parameter behavior:
- подржано ако је Show legend постављено на "Омогућено", и Прикажи min/avg/max је постављено на "Disabled"

Проблеми

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

|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) представља одређени скуп података, док други број, ако постоји, представља конфигурисаног домаћина или ставку. :::

Parameter type name value
Host patterns 1 or.0.hosts.0 Host име или образац (нпр., Zabbix*).

Овај параметар није подржан ако се конфигурише виџет на template dashboard.

Parameter behavior:
- обавезно ако се конфигурише Overrides
Item patterns 1 or.0.items.0 Item назив или образац (нпр., *: Number of processed *values per second).
Када конфигуришете виџет на template dashboard, треба да се подесе само обрасци за ставке конфигурисане на шаблону.

Parameter behavior:
- обавезно ако се конфигурише Overrides
*Base color** 1 or.0.color Хексадецимални код боје (нпр., FF0000).
* Width* 0 or.0.width Могуће вредности се крећу од 1-10.
* Draw* 0 or.0.type 0 - Линија;
1 - Тачке;
2 - Степенасти графикон;
3 - Стубићи.
* Transparency* 0 or.0.transparency Могуће вредности се крећу од 1-10.
* Fill* 0 or.0.fill Могуће вредности се крећу од 1-10.
Point size 0 or.0.pointsize Могуће вредности се крећу од 1-10.
Missing data 0 or.0.missingdatafunc
0 - Нема;
1 - Повезано;
2 - Третирајте као 0;
3 - Последње познато.
Y-axis 0 or.0.axisy 0 - Лево;
1 - Десно.
Time shift 1 or.0.timeshift Важећи временски низ (нпр., 3600, 1h, итд.).
Можете користити time suffixes. Негативне вредности су дозвољене.

Примери

Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет 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
       }

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