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ī.

Paplašinātā konfigurācija

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti Gauge logrīkam.

Skaitlis Thresholds īpašības nosaukumā (piemēram, thresholds.0.color) norāda sliekšņa vietu sarakstā, kas sakārtots augošā secībā. 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, ieskaitot makrosus.
Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi.

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

Noklusējums: 15.
Vertikālā pozīcija 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ālvietas 0 decimal_places Iespējamās vērtības diapazonā no 1 līdz 10.

Noklusējums: 2.
Izmērs 0 value_size Iespējamās vērtības diapazonā 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 diapazonā 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"
Pozīcija 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 tas ir iestatīts uz kādu no šīm ar laiku saistītajām 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 diapazonā 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 ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots"
Skala
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 ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots"
Izmērs 0 scale_size Iespējamās vērtības diapazonā no 1 līdz 100.

Noklusējums: 15.

Parametra darbība:
- atbalstīts, ja ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots"
Decimālvietas 0 scale_decimal_places Iespējamās vērtības diapazonā no 1 līdz 10.

Noklusējums: 0.

Parametra darbība:
- atbalstīts, ja ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc 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 Sliekšņi ir iestatīti un ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc 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 Sliekšņi ir iestatīti
Loka izmērs 0 th_arc_size Iespējamās vērtības diapazonā no 1 līdz 100.

Noklusējums: 5.

Parametra darbība:
- atbalstīts, ja Show arc 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ī