6 Mērinstruments

Apraksts

Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt Gauge logrīku dashboard.create un dashboard.update metodēs.

Logrīka fields īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt iebūvētos logrīkus un izveidot pielāgotus logrīkus, taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu Gauge logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību.

პარამეტრები

Tālāk norādītie parametri ir atbalstīti Gauge logrīkam.

Parameter type name value
Refresh interval 0 rf_rate 0 - Nav atsvaidzināšanas;
10 - 10 sekundes;
30 - 30 sekundes;
60 - (noklusējums) 1 minūte;
120 - 2 minūtes;
600 - 10 minūtes;
900 - 15 minūtes.
Item 4 itemid.0 Vienuma ID.

Parametra darbība:
- obligāts, ja Item (Widget) nav iestatīts
Item (Widget) 1 itemid._reference Vienuma ID vietā:
ABCDE._itemid - iestatiet saderīgu logrīku (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu vienumiem.

Parametra darbība:
- obligāts, ja Item nav iestatīts
Min 1 min Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "1d", "2w", "4K", "8G").

Noklusējums: "0".
Max 1 max Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "1d", "2w", "4K", "8G").

Noklusējums: "100".
Value arc 1 value_arc_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: "" (tukšs).
Arc background 1 empty_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: "" (tukšs).
Background 1 bg_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: "" (tukšs).
Show 0 show.0 1 - Apraksts;
2 - Vērtība;
3 - Bulta;
4 - Skala;
5 - Vērtības loks.

Piezīme: lai konfigurētu vairākas vērtības, izveidojiet dashboard widget field objektu katrai vērtībai ar pieaugošu numuru īpašuma nosaukumā.

Noklusējums: 1, 2, 4, 5.

Vērtības "Bulta" un "Skala" netiek atbalstītas, ja abi nosacījumi ir spēkā:
- nav iestatīts neviens dashboard widget field objekts Show ar vērtību "Vērtības loks";
- Show arc papildu konfigurācijas parametrs ir iestatīts uz "Disabled".

Papildu konfigurācijas parametri Show opcijām netiek atbalstīti, ja nav iestatīti dashboard widget field objekti ar attiecīgajām vērtībām.
Override host 1 override_hostid._reference ABCDE._hostid - iestatiet saderīgu logrīku (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu hosts;
DASHBOARD._hostid - iestatiet paneļa Host atlasītāju kā datu avotu hosts.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.

Papildu konfigurācija

Gauge logrīkam tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri.

Skaitlis rekvizīta Thresholds nosaukumā (piemēram, thresholds.0.color) norāda sliekšņa vietu augošā secībā sakārtotā sarakstā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē vērtības tiks sakārtotas augošā secībā (piemēram, "thresholds.0.threshold":"5""thresholds.0.threshold":"1"; "thresholds.1.threshold":"1""thresholds.1.threshold": "5").

Parametrs type name value
Leņķis 0 angle Iespējamās vērtības: 180 (noklusējums) vai 270.
Apraksts
Apraksts 1 description Jebkura virknes vērtība, tostarp makro.
Atbalstītie makro: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makro.

Noklusējums: {ITEM.NAME}.
Izmērs 0 desc_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 15.
Vertikālais novietojums 0 desc_v_pos 0 - augšā;
1 - (noklusējums) apakšā.
Treknraksts 0 desc_bold 0 - (noklusējums) atspējots;
1 - iespējots.
Krāsa 1 desc_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Vērtība
Decimāldaļu skaits 0 decimal_places Iespējamās vērtības ir no 1 līdz 10.

Noklusējums: 2.
Izmērs 0 value_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 25.
Treknraksts 0 value_bold 0 - (noklusējums) atspējots;
1 - iespējots.
Krāsa 1 value_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Mērvienības
Mērvienības (izvēles rūtiņa) 0 units_show 0 - atspējots;
1 - (noklusējums) iespējots.
Mērvienības (vērtība) 1 units Jebkura virknes vērtība.

Parametra darbība:
- atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz “Iespējots”
Izmērs 0 units_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 25.

Parametra darbība:
- atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz “Iespējots”
Treknraksts 0 units_bold 0 - (noklusējums) atspējots;
1 - iespējots.

Parametra darbība:
- atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz “Iespējots”
Novietojums 0 units_pos 0 - pirms vērtības;
1 - virs vērtības;
2 - (noklusējums) pēc vērtības;
3 - zem vērtības.

Parametra darbība:
- atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz “Iespējots”

Šis parametrs tiek ignorēts, ja tam iestatīta kāda no tālāk norādītajām laika mērvienībām: unixtime, uptime, s.
Krāsa 1 units_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Vērtības loks
Loka izmērs 0 value_arc_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 20.
Rādītājs
Krāsa 1 needle_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).

Parametra darbība:
- atbalstīts, ja informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots”
Mērogs
Rādīt mērvienības 0 scale_show_units 0 - atspējots;
1 - (noklusējums) iespējots.

Parametra darbība:
- atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz “Iespējots” un informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots”
Izmērs 0 scale_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 15.

Parametra darbība:
- atbalstīts, ja informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots”
Decimāldaļu skaits 0 scale_decimal_places Iespējamās vērtības ir no 1 līdz 10.

Noklusējums: 0.

Parametra darbība:
- atbalstīts, ja informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots”
Sliekšņi
Krāsa 1 thresholds.0.color Heksadecimāls krāsas kods (piemēram, FF0000).
Slieksnis 1 thresholds.0.threshold Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, “1d”, “2w”, “4K”, “8G”).
Rādīt etiķetes 0 th_show_labels 0 - (noklusējums) atspējots;
1 - iespējots.

Parametra darbība:
- atbalstīts, ja ir iestatīti Sliekšņi un informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots”
Rādīt loku 0 th_show_arc 0 - (noklusējums) atspējots;
1 - iespējots.

Parametra darbība:
- atbalstīts, ja ir iestatīti Sliekšņi
Loka izmērs 0 th_arc_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 5.

Parametra darbība:
- atbalstīts, ja Rādīt loku ir iestatīts uz “Iespējots”

Piemēri

Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju Mērinstrumenta logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.

Gauge logrīka konfigurēšana

Konfigurējiet Gauge logrīku, kas attēlo vienuma vērtību vienumam "44474" (Saskarne enp0s3: Nosūtītie biti). Papildus vizuāli pielāgojiet logrīku, izmantojot vairākas papildu opcijas, tostarp sliekšņus.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "gauge",
                        "name": "Gauge",
                        "x": 0,
                        "y": 0,
                        "width": 18,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 44474
                            },
                            {
                                "type": 1,
                                "name": "min",
                                "value": "100000"
                            },
                            {
                                "type": 1,
                                "name": "max",
                                "value": "1000000"
                            },
                            {
                                "type": 0,
                                "name": "show.0",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show.1",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show.2",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "show.4",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "show.5",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "angle",
                                "value": 270
                            },
                            {
                                "type": 0,
                                "name": "desc_size",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "desc_bold",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "decimal_places",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "value_bold",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "units_size",
                                "value": 15
                            },
                            {
                                "type": 0,
                                "name": "units_pos",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "needle_color",
                                "value": "3C3C3C"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "FF465C"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.threshold",
                                "value": "700000"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "FFD54F"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.threshold",
                                "value": "500000"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.color",
                                "value": "0EC9AC"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.threshold",
                                "value": "100000"
                            },
                            {
                                "type": 0,
                                "name": "th_show_labels",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "th_show_arc",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "th_arc_size",
                                "value": 15
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Skatiet arī