12 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 widget field objektu katrai hostu grupai, pieaugot numuram īpašības 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 compatible widget (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu hostu grupām.

Š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 widget field objektu katram hostam, pieaugot numuram īpašības 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 selector kā datu avotu hostiem;
ABCDE._hostids - iestatiet compatible widget (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu hostiem.

Š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šības nosaukumā norāda taga secību tagu izvērtēšanas sarakstā.

Parameter behavior:
- required ja konfigurē 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šības nosaukumā norāda taga secību tagu izvērtēšanas sarakstā.

Parameter behavior:
- required ja konfigurē 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šības nosaukumā norāda taga secību tagu izvērtēšanas sarakstā.

Parameter behavior:
- required ja konfigurē 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 widget field objektu katram vienumu paraugam, pieaugot numuram īpašības nosaukumā.

Parameter behavior:
- required
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šības nosaukumā norāda taga secību tagu izvērtēšanas sarakstā.

Parameter behavior:
- required ja konfigurē 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šības nosaukumā norāda taga secību tagu izvērtēšanas sarakstā.

Parameter behavior:
- required ja konfigurē Item tags
Tag value 1 item_tags.0.value Jebkura virknes vērtība.

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

Parameter behavior:
- required ja konfigurē 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 widget field objektu katrai vērtībai, pieaugot numuram īpašības nosaukumā.

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

Parameter behavior:
- required

Papildu konfigurācija

Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti Honeycomb vienumam.

Skaitlis Thresholds īpašuma nosaukumā (piem., 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ā, vērtības pēc vienuma konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē tiks sakārtotas augošā secībā (piem., "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").

Parameter 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 makrosi.
Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi.

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 diapazonā 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 diapazonā 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., FF0000).

Noklusējums: atkarībā no Settings object un User object theme:
1F2C33 "blue-theme" vai "hc-light";
EEEEEE "dark-theme" vai "hc-dark".
Vienības (atzīme) 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"
Vienības (vērtība) 1 primary_label_units Jebkura virknes vērtība.

"" (tukšs)

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un Vienības (atzīme) ir iestatīts 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 Vienības (atzīme) ir iestatīts uz "Iespējots"

Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm ar laiku saistītajām vienī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 makrosi.
Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi.

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 diapazonā 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 diapazonā 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., FF0000).

Noklusējums: atkarībā no Settings object un User object theme:
1F2C33 "blue-theme" vai "hc-light";
EEEEEE "dark-theme" vai "hc-dark".
Vienības (atzīme) 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"
Vienības (vērtība) 1 secondary_label_units Jebkura virknes vērtība.

"" (tukšs)

Parametra darbība:
- atbalstīts, ja Tips ir iestatīts uz "Vērtība" un Vienības (atzīme) ir iestatīts 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 Vienības (atzīme) ir iestatīts uz "Iespējots"

Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm ar laiku saistītajām vienībām: unixtime, uptime, s.
Fona krāsa
Fona krāsa 1 bg_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: atkarībā no Settings object un User object theme:
D9E7ED "blue-theme";
3D5059 "dark-theme";
AAD7E9 "hc-light";
335463 "hc-dark".
Sliekšņi
Krāsu interpolācija 0 interpolation 0 - Atspējots;
1 - (noklusējums) Iespējots.
Krāsa 1 thresholds.0.color Heksadecimāls krāsas kods (piem., FF0000).
Slieksnis 1 thresholds.0.threshold Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "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ī