9 Граф
Опис
Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање
виџета Graph у методама dashboard.create и dashboard.update.
Својства fields виџета се не проверавају током прављења или ажурирања контролне табле.
Ово омогућава корисницима да модификују built-in widgets и креирају custom widgets, али такође уводи ризик од неправилног креирања или ажурирања виџета.
Да бисте осигурали успешно креирање или ажурирање виџета Geomap, погледајте понашање параметара наведено у табелама испод.
Параметери
Следећи параметри су подржани за виџет 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 | Item ID. Када конфигуришете виџет на template dashboard само ставке конфигурисане на шаблону треба да буду подешене. Напомена: Да бисте конфигурисали више ставки, креирајте објекат поља виџета контролне табле за сваку ставку са повећаним бројем у имену својства. Parameter behavior: - обавезно ако је Тип скупа података подешен на "Листа ставки" и Ставке (Виџет) нису подешене |
|
| Items (Widget) | 1 | ds.0.itemids.0._reference | Уместо Item ID:ABCDE._itemid - подесите [compatible widget] (/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са Reference параметром подешеним на "ABCDE") као извор података за ставке.Напомена: Да бисте конфигурисали више виџета, креирајте објекат поља виџета контролне табле за сваки виџет са увећаним бројем у називу својства. Овај параметар је подржан од Zabbix-а 7.0.1. Parameter behavior: - обавезно ако је Тип скупа података подешен на "Листа ставки" и Ставке нису подешене |
|
| Color | 1 | ds.0.color.0 | Хексадецимални код боје (нпр., FF0000).Parameter behavior: - обавезно ако је Data set type постављено на "Листа ставки" |
|
| Host patterns | 1 | ds.0.hosts.0 | Host назив или шаблон (нпр., "Zabbix*"). Parameter behavior: - required ако је Тип скупа података постављен на "Шаблони ставке" Овај параметар није подржан ако се виџет конфигурише на template dashboard. |
|
|^|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 |
|---|---|---|---|
| Left Y | 0 | lefty | 0 - Онемогућено; 1 - (подразумевано) Омогућено. Parameter behavior: - подржано ако је Y-оса (у Data set конфигурацији) постављена на "Лево" |
| Right Y | 0 | righty | 0 - (подразумевано) Онемогућено; 1 - Омогућено. Parameter behavior: - подржано ако је Y-оса (у [Data set*](#data-set) конфигурацији) постављена на "Десно" |
| 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 - (default) Омогућено. |
Легенда
Следећи параметри су подржани за конфигурисање Легенде.
| 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.
Први број у називу својства (нпр., 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 реда, као и минималне, максималне и просечне вредности скупова података.
{
"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
}