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

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

Skaitlis Thresholds īpašuma nosaukumā (piem., thresholds.0.color) norāda sliekšņa pozīciju sarakstā, kas sakārtots augošā secībā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, vērtības pēc sīkrīka 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
Primary label
Type 0 primary_label_type 0 - (noklusējums) Teksts;
1 - Vērtība.
Text 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 Type ir iestatīts uz "Text"
Decimal places 0 primary_label_decimal_places Iespējamās vērtības no 0 līdz 6.

Noklusējums: 2.

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

Noklusējums: 20.

Parametra darbība:
- atbalstīts, ja Size (type) ir iestatīts uz "Custom"
Bold 0 primary_label_bold 0 - (noklusējums) Atspējots;
1 - Iespējots.
Color 1 primary_label_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: atkarīgs no Settings object un User object theme:
1F2C33 "blue-theme" vai "hc-light";
EEEEEE "dark-theme" vai "hc-dark".
Units (checkbox) 0 primary_label_units_show 0 - Atspējots;
1 - (noklusējums) Iespējots.

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value"
Units (value) 1 primary_label_units Jebkura virknes vērtība.

"" (tukšs)

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value" un Units (checkbox) ir iestatīts uz "Enabled"
Position 0 primary_label_units_pos 0 - Pirms vērtības;
1 - (noklusējums) Pēc vērtības.

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value" un Units (checkbox) ir iestatīts uz "Enabled"

Š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.
Secondary label
Type 0 secondary_label_type 0 - Teksts;
1 - (noklusējums) Vērtība.
Text 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 Type ir iestatīts uz "Text"
Decimal places 0 secondary_label_decimal_places Iespējamās vērtības no 0 līdz 6.

Noklusējums: 2.

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

Noklusējums: 30.

Parametra darbība:
- atbalstīts, ja Size (type) ir iestatīts uz "Custom"
Bold 0 secondary_label_bold 0 - Atspējots;
1 - (noklusējums) Iespējots.
Color 1 secondary_label_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: atkarīgs no Settings object un User object theme:
1F2C33 "blue-theme" vai "hc-light";
EEEEEE "dark-theme" vai "hc-dark".
Units (checkbox) 0 secondary_label_units_show 0 - Atspējots;
1 - (noklusējums) Iespējots.

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value"
Units (value) 1 secondary_label_units Jebkura virknes vērtība.

"" (tukšs)

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value" un Units (checkbox) ir iestatīts uz "Enabled"
Position 0 secondary_label_position 0 - Pirms vērtības;
1 - (noklusējums) Pēc vērtības.

Parametra darbība:
- atbalstīts, ja Type ir iestatīts uz "Value" un Units (checkbox) ir iestatīts uz "Enabled"

Š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.
Background color
Background color 1 bg_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: atkarīgs no Settings object un User object theme:
D9E7ED "blue-theme";
3D5059 "dark-theme";
AAD7E9 "hc-light";
335463 "hc-dark".
Thresholds
Color interpolation 0 interpolation 0 - Atspējots;
1 - (noklusējums) Iespējots.
Color 1 thresholds.0.color Heksadecimāls krāsas kods (piem., FF0000).
Threshold 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ī