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 tiek atbalstīti Honeycomb logrīkam.

Parametrs type name value
Atsvaidzināšanas intervāls 0 rf_rate 0 - Bez 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.
Hostu grupas 2 groupids.0 Hostu grupas ID.

Piezīme: Lai konfigurētu vairākas hostu grupas, izveidojiet dashboard logrīka lauka objektu katrai hostu grupai ar palielinātu numuru īpašības nosaukumā.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Hostu grupas (logrīks) 1 groupids._reference Hostu grupas ID vietā:
ABCDE._hostgroupids - iestatiet saderīgu logrīku (ar tā parametru Reference, kas iestatīts uz "ABCDE") kā datu avotu hostu grupām.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Hosti 3 hostids.0 Hosta ID.

Piezīme: Lai konfigurētu vairākus hostus, izveidojiet dashboard logrīka lauka objektu katram hostam ar palielinātu numuru īpašības nosaukumā. Vairākiem hostiem parametrs Hostu grupas vai nu vispār nedrīkst būt konfigurēts, vai arī tam jābūt konfigurētam ar vismaz vienu hostu grupu, kurai pieder konfigurētie hosti.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Hosti (logrīks/panelis) 1 hostids._reference Hosta ID vietā:
DASHBOARD.hostids - iestatiet paneļa hostu atlasītāju kā datu avotu hostiem;
ABCDE._hostids - iestatiet saderīgu logrīku (ar tā parametru Reference, kas iestatīts uz "ABCDE") kā datu avotu hostiem.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Hostu birkas
Novērtēšanas tips 0 evaltype_host 0 - (noklusējums) Un/Vai;
2 - Vai.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Birkas nosaukums 1 host_tags.0.tag Jebkura virknes vērtība.

Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Hostu birkas

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Operators 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 birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Hostu birkas

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Birkas vērtība 1 host_tags.0.value Jebkura virknes vērtība.

Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Hostu birkas

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Vienumu šabloni 1 items.0 Vienuma nosaukums vai šablons.

Piezīme: Lai konfigurētu vairākus vienumu šablonus, izveidojiet dashboard logrīka lauka objektu katram vienumu šablonam ar palielinātu numuru īpašības nosaukumā.

Parametra darbība:
- obligāts
Vienumu birkas
Novērtēšanas tips 0 evaltype_item 0 - (noklusējums) Un/Vai;
2 - Vai.
Birkas nosaukums 1 item_tags.0.tag Jebkura virknes vērtība.

Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas
Operators 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 birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas
Birkas vērtība 1 item_tags.0.value Jebkura virknes vērtība.

Piezīme: Numurs īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas
Rādīt hostus uzturēšanā 0 maintenance 0 - (noklusējums) Atspējots;
1 - Iespējots.
Rādīt 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 logrīka lauka objektu katrai vērtībai ar palielinātu numuru īpašības nosaukumā.

Noklusējums: 1, 2.
Reference 1 reference Jebkura virknes vērtība, kas sastāv no 5 rakstzīmēm (piemēram, ABCDE vai JBPNL). Šai vērtībai jābūt unikālai panelī, kuram pieder logrīks.

Parametra darbība:
- obligāts

Papildu konfigurācija

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

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 sīklietotnes 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 - (default) Text;
1 - Value.
Text 1 primary_label Any string value, including macros.
Supported macros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, user macros.

Default: {HOST.NAME}

Parameter behavior:
- supported if Type is set to "Text"
Decimal places 0 primary_label_decimal_places Possible values range from 0-6.

Default: 2.

Parameter behavior:
- supported if Type is set to "Value"
Size (type) 0 primary_label_size_type 0 - (default) Auto;
1 - Custom.
Size 0 primary_label_size Possible values range from 1-100.

Default: 20.

Parameter behavior:
- supported if Size (type) is set to "Custom"
Bold 0 primary_label_bold 0 - (default) Disabled;
1 - Enabled.
Color 1 primary_label_color Hexadecimal color code (e.g., FF0000).

Default: based on theme of Settings object and User object:
1F2C33 for "blue-theme", "blue-classic-theme", or "hc-light";
EEEEEE for "dark-theme", "dark-classic-theme", or "hc-dark".
Units (checkbox) 0 primary_label_units_show 0 - Disabled;
1 - (default) Enabled.

Parameter behavior:
- supported if Type is set to "Value"
Units (value) 1 primary_label_units Any string value.

"" (empty)

Parameter behavior:
- supported if Type is set to "Value" and Units (checkbox) is set to "Enabled"
Position 0 primary_label_units_pos 0 - Before value;
1 - (default) After value.

Parameter behavior:
- supported if Type is set to "Value" and Units (checkbox) is set to "Enabled"

This parameter is ignored if set to one of the following time-related units: unixtime, uptime, s.
Secondary label
Type 0 secondary_label_type 0 - Text;
1 - (default) Value.
Text 1 secondary_label Any string value, including macros.
Supported macros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, user macros.

Default: {{ITEM.LASTVALUE}.fmtnum(2)}

Parameter behavior:
- supported if Type is set to "Text"
Decimal places 0 secondary_label_decimal_places Possible values range from 0-6.

Default: 2.

Parameter behavior:
- supported if Type is set to "Value"
Size (type) 0 secondary_label_size_type 0 - (default) Auto;
1 - Custom.
Size 0 secondary_label_size Possible values range from 1-100.

Default: 30.

Parameter behavior:
- supported if Size (type) is set to "Custom"
Bold 0 secondary_label_bold 0 - Disabled;
1 - (default) Enabled.
Color 1 secondary_label_color Hexadecimal color code (e.g., FF0000).

Default: based on theme of Settings object and User object:
1F2C33 for "blue-theme", "blue-classic-theme", or "hc-light";
EEEEEE for "dark-theme", "dark-classic-theme", or "hc-dark".
Units (checkbox) 0 secondary_label_units_show 0 - Disabled;
1 - (default) Enabled.

Parameter behavior:
- supported if Type is set to "Value"
Units (value) 1 secondary_label_units Any string value.

"" (empty)

Parameter behavior:
- supported if Type is set to "Value" and Units (checkbox) is set to "Enabled"
Position 0 secondary_label_position 0 - Before value;
1 - (default) After value.

Parameter behavior:
- supported if Type is set to "Value" and Units (checkbox) is set to "Enabled"

This parameter is ignored if set to one of the following time-related units: unixtime, uptime, s.
Background color
Background color 1 bg_color Hexadecimal color code (e.g., FF0000).

Default: based on theme of Settings object and User object:
D9E7ED for "blue-theme" and "blue-classic-theme";
3D5059 for "dark-theme" and "dark-classic-theme";
AAD7E9 for "hc-light";
335463 for "hc-dark".
Thresholds
Color interpolation 0 interpolation 0 - Disabled;
1 - (default) Enabled.
Color 1 thresholds.0.color Hexadecimal color code (e.g., FF0000).
Threshold 1 thresholds.0.threshold Any numeric value. Suffixes (e.g., "1d", "2w", "4K", "8G") are supported.

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ī