10 Графикон (класичан)

Опис

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

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

Параметри

Следећи параметри су подржани за виџет Графикон (класичнiи).

Parameter type name value
Refresh interval 0 rf_rate 0 - Нема освежавања;
10 - 10 секунди;
30 - 30 секунди;
60 - (подразумевано) 1 минут;
120 - 2 минута;
600 - 10 минута;
900 - 15 минута.
Source 0 source_type 0 - (подразумевано) Графикон;
1 - Једноставан графикон.
Graph 6 graphid.0 Graph ID.

Parameter behavior:
- обавезно ако је Извор подешен на "Графикон"
Graph (Widget) 1 graphid._reference Уместо Graph ID:
ABCDE._graphid - поставите compatible widget (са параметром Референца постављеним на "ABCDE") као извор података за графиконе.

[Parameter behavior] (/manual/api/reference_commentary#parameter-behavior):
- обавезно ако је Извор постављен на "Једноставан графикон" и Графикон није подешен
Item 4 itemid.0 Item ID.

Parameter behavior:
- обавезно ако је Извор постављен на "Једноставан график" и Ставка (виџет) није постављена
Item (Widget) 1 itemid._reference Уместо Item ID:
ABCDE._itemid - поставите compatible widget (са параметром Референце постављеним на "ABCDE") као извор података за ставке.

Parameter behavior:
- обавезно ако је Извор постављен на "Једноставан графикон" и Ставка није подешена
Time period 1 time_period._reference DASHBOARD._timeperiod - поставите Time period selector као извор података;
ABCDE._timeperiod – поставите compatible widget као извор података.

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

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

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

Parameter behavior:
- подржано ако Временски период није подешен
Show legend 0 show_legend 0 - Онемогућено;
1 - (подразумевано) Омогућено.
Override host 1 override_hostid._reference ABCDE._hostid - поставите compatible widget (са његовим параметром Референца постављеном на "ABCDE") као извор података за домаћине;
DASHBOARD._hostid - подесите на контролној табли Host selector као извор података за домаћине.

Овај параметар није подржан ако се виџет конфигурише на template dashboard.
Reference 1 reference Било која вредност стринга која се састоји од 5 карактера (нпр. ABCDE или JBPNL). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.

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

Примери

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

Конфигурисање виџета Графикон (класични)

Конфигуришите виџет Графикон (класични) који приказује једноставан график за ставку "42269".

Request:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graph",
                        "name": "Graph (classic)",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "source_type",
                                "value": 1
                            },
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42269
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "RSTUV"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Одговор:

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

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