11 Honeycomb

Apraksts

Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt Honeycomb 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 logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu Honeycomb logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās.

Parametri

Tālāk norādītie parametri ir atbalstīti Honeycomb sīklietotnei.

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.
Host groups 2 groupids.0 Host group ID.

Piezīme: lai konfigurētu vairākas hostu grupas, izveidojiet dashboard sīklietotnes lauka objektu katrai hostu grupai, pieaugot numuram īpašuma nosaukumā.

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Host groups (Widget) 1 groupids._reference Host group ID vietā:
ABCDE._hostgroupids - iestatiet saderīgu sīklietotni (ar tās Reference parametru iestatītu uz "ABCDE") kā hostu grupu datu avotu.

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Hosts 3 hostids.0 Host ID.

Piezīme: lai konfigurētu vairākus hostus, izveidojiet dashboard sīklietotnes lauka objektu katram hostam, pieaugot numuram īpašuma nosaukumā. Vairākiem hostiem parametram Host groups jābūt vai nu vispār nekonfigurētam, vai arī konfigurētam ar vismaz vienu hostu grupu, kurai pieder konfigurētie hosti.

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Hosts (Widget/Dashboard) 1 hostids._reference Host ID vietā:
DASHBOARD.hostids - iestatiet Host atlasītāju kā hostu datu avotu;
ABCDE._hostids - iestatiet saderīgu sīklietotni (ar tās Reference parametru iestatītu uz "ABCDE") kā hostu datu avotu.

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Host tags
Evaluation type 0 evaltype_host 0 - (noklusējums) And/Or;
2 - Or.

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Tag name 1 host_tags.0.tag Jebkura virknes vērtība.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Host tags

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Operator 0 host_tags.0.operator 0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Host tags

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Tag value 1 host_tags.0.value Jebkura virknes vērtība.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Host tags

Šis parametrs netiek atbalstīts, konfigurējot sīklietotni template dashboard.
Item patterns 1 items.0 Item nosaukums vai paraugs.

Piezīme: lai konfigurētu vairākus vienumu paraugus, izveidojiet dashboard sīklietotnes lauka objektu katram vienumu paraugam, pieaugot numuram īpašuma nosaukumā.

Parametra darbība:
- obligāts
Item tags
Evaluation type 0 evaltype_item 0 - (noklusējums) And/Or;
2 - Or.
Tag name 1 item_tags.0.tag Jebkura virknes vērtība.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Item tags
Operator 0 item_tags.0.operator 0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Item tags
Tag value 1 item_tags.0.value Jebkura virknes vērtība.

Piezīme: numurs īpašuma nosaukumā norāda taga secību tagu novērtēšanas sarakstā.

Parametra darbība:
- obligāts, konfigurējot Item tags
Show hosts in maintenance 0 maintenance 0 - (noklusējums) Atspējots;
1 - Iespējots.
Show 0 show.0 1 - Primārā etiķete;
2 - Sekundārā etiķete.

Piezīme: lai konfigurētu vairākas vērtības, izveidojiet dashboard sīklietotnes lauka objektu katrai vērtībai, pieaugot numuram īpašuma nosaukumā.

Noklusējums: 1, 2.
Reference 1 reference Jebkura 5 rakstzīmju virkne (piem., ABCDE vai JBPNL). Šai vērtībai jābūt unikālai dashboard, kurai pieder sīklietotne.

Parametra darbība:
- obligāts

Papildu konfigurācija

Honeycomb 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
Primārā etiķete
Tips 0 primary_label_type 0 - (noklusējums) Teksts;
1 - Vērtība.
Teksts 1 primary_label Jebkura virknes vērtība, tostarp makro.
Atbalstītie makro: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makro.

Noklusējums: {HOST.NAME}

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Teksts"
Decimāldaļas 0 primary_label_decimal_places Iespējamās vērtības ir no 0 līdz 6.

Noklusējums: 2.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība"
Izmērs (tips) 0 primary_label_size_type 0 - (noklusējums) Automātiski;
1 - Pielāgots.
Izmērs 0 primary_label_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 20.

Parametra darbība:
- atbalstīts, ja Izmērs (tips) ir iestatīts uz "Pielāgots"
Treknraksts 0 primary_label_bold 0 - (noklusējums) Atspējots;
1 - Iespējots.
Krāsa 1 primary_label_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: pamatojoties uz Settings object un User object theme:
1F2C33 iestatījumam "blue-theme" vai "hc-light";
EEEEEE iestatījumam "dark-theme" vai "hc-dark".
Mērvienības (izvēles rūtiņa) 0 primary_label_units_show 0 - Atspējots;
1 - (noklusējums) Iespējots.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība"
Mērvienības (vērtība) 1 primary_label_units Jebkura virknes vērtība.

"" (tukša)

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots"
Pozīcija 0 primary_label_units_pos 0 - Pirms vērtības;
1 - (noklusējums) Pēc vērtības.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un 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 ar laiku saistītajām mērvienībām: unixtime, uptime, s.
Sekundārā etiķete
Tips 0 secondary_label_type 0 - Teksts;
1 - (noklusējums) Vērtība.
Teksts 1 secondary_label Jebkura virknes vērtība, tostarp makro.
Atbalstītie makro: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makro.

Noklusējums: {{ITEM.LASTVALUE}.fmtnum(2)}

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Teksts"
Decimāldaļas 0 secondary_label_decimal_places Iespējamās vērtības ir no 0 līdz 6.

Noklusējums: 2.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība"
Izmērs (tips) 0 secondary_label_size_type 0 - (noklusējums) Automātiski;
1 - Pielāgots.
Izmērs 0 secondary_label_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 30.

Parametra darbība:
- atbalstīts, ja Izmērs (tips) ir iestatīts uz "Pielāgots"
Treknraksts 0 secondary_label_bold 0 - Atspējots;
1 - (noklusējums) Iespējots.
Krāsa 1 secondary_label_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: pamatojoties uz Settings object un User object theme:
1F2C33 iestatījumam "blue-theme" vai "hc-light";
EEEEEE iestatījumam "dark-theme" vai "hc-dark".
Mērvienības (izvēles rūtiņa) 0 secondary_label_units_show 0 - Atspējots;
1 - (noklusējums) Iespējots.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība"
Mērvienības (vērtība) 1 secondary_label_units Jebkura virknes vērtība.

"" (tukša)

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots"
Pozīcija 0 secondary_label_position 0 - Pirms vērtības;
1 - (noklusējums) Pēc vērtības.

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un 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 ar laiku saistītajām mērvienībām: unixtime, uptime, s.
Fona krāsa
Fona krāsa 1 bg_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: pamatojoties uz Settings object un User object theme:
D9E7ED iestatījumam "blue-theme";
3D5059 iestatījumam "dark-theme";
AAD7E9 iestatījumam "hc-light";
335463 iestatījumam "hc-dark".
Sliekšņi
Krāsu interpolācija 0 interpolation 0 - Atspējota;
1 - (noklusējums) Iespējota.
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").

Piemēri

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

Honeycomb logrīka konfigurēšana

Konfigurējiet Honeycomb logrīku, kas attēlo Zabbix servera procesu noslodzi. Papildus mainiet honeycomb šūnu primāro etiķeti un vizuāli precizējiet logrīku ar sliekšņiem.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "honeycomb",
                        "name": "Honeycomb",
                        "x": "0",
                        "y": "0",
                        "width": "24",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "items.0",
                                "value": "Zabbix server: Utilization*"
                            },
                            {
                                "type": 1,
                                "name": "primary_label",
                                "value": "{ITEM.NAME}"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "0EC9AC"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.threshold",
                                "value": "0"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "FFD54F"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.threshold",
                                "value": "70"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.color",
                                "value": "FF465C"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.2.threshold",
                                "value": "90"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "KSTMQ"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Skatiet arī