17 Valor de l'element

Descripció

Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny Valor d'element als mètodes dashboard.create i dashboard.update.

Les propietats dels camps del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels ginys integrats i crear ginys personalitzats, però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny Valor d'element, consulteu el comportament dels paràmetres que es descriuen a les taules següents.

Paràmetres

S'admeten els paràmetres següents per al giny Valor d'element.

Paràmetre tipus nom
Interval d'actualització 0 rf_rate 0 - Sense actualització;
10 - 10 segons;
30 - 30 segons;
60 - (per defecte) 1 minut;
120 - 2 minuts;
600 - 10 minuts;
900 - 15 minuts.
Element 4 itemid.0
Element (Giny) 1 itemid._reference
Veure 0 show.0
Substitueix l'equip 1 override_hostid._reference

Configuració avançada

Els paràmetres següents s'admeten si la Configuració avançada és establerta a "Habilitada".

El nombre del nom de propietat Llindars (p. ex., thresholds.color.0) fa referència al lloc del llindar en una llista, en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p. ex., "threshold.threshold.0":"5""threshold.threshold.0":"1"; "threshold.threshold.1":"1""threshold.threshold. 1": "5").

Paràmetre tipus nom valor
Color de fons 1 bg_color Codi de color hexadecimal (p.e. FF0000).

Per defecte: "" (buit).
Llindars
Color 1 thresholds.color.0 Codi de color hexadecimal (p.e. FF0000).
Llindar 1 thresholds.threshold.0 Qualsevol valor de cadena.
Funció d'agregació 0 funció_agregada 0 - (per defecte) no emprada;
1 - mín;
2 - màxim;
3 - mitjana;
4 - recompte;
5 - suma;
6 - primer;
7 - darrer.
Descripció

Els paràmetres següents de configuració avançada s'admeten si Veure és establert a "Descripció".

Paràmetre tipus nom valor
Descripció 1 descripció Qualsevol valor de cadena, incloses les macros.
Macros admeses: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros d'usuari.
< br>Per defecte: {ITEM.NAME}.
Posició horitzontal 0 desc_h_pos 0 - Esquerra;
1 - (per defecte) Centre;
2 - Dreta.

Dos o més elements (Descripció, Valor, Hora) no poden pas tindre la mateixa Posició horitzontal i Posició vertical.
Posició vertical 0 desc_v_pos 0 - Damunt;
1 - Mitjà;
2 - (per defecte) Sota.

Dos o més elements (Descripció, Valor, Temps) no poden pas tindre la mateixa Posició horitzontal i Posició vertical.
Mida 0 desc_size Valors vàlids dins el rang 1-100.

Per defecte: 15.
Ngreta 0 desc_bold 0 - (per defecte) Deshabilitat;
1 - Habilitat.
Color 1 desc_color Codi de color hexadecimal (p.e. FF0000).

Per defecte: "" (buit).
Valor

Els paràmetres següents de configuració avançada s'admeten si Veure és establert a "Valor".

|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Llocs decimals|<|<|<|<| |<|Llocs decimals|0|Llocs_decimals|Els valors vàlids van d'1 a 10.

Per defecte: 2.| |^|Mida|0|mida_decimal|Els valors vàlids oscil·len entre 1 i 100.

Per defecte: 35.| |Posició|<|<|<|<| |<|Posició horitzontal|0|value_h_pos|0 - Esquerra;
1 - (per defecte) Centre;
2 - Dreta.

Dos o més elements (Descripció, Valor, Temps) no poden pas tindre la mateixa Posició horitzontal i Posició vertical.| |^|Posició vertical|0|value_v_pos|0 - Amunt;
1 - (per defecte) Mitjà;
2 - A baix.

Dos o més elements (Descripció, Valor, Temps) no poden pas tindre la mateixa Posició horitzontal i Posició vertical.| |^|Mida|0|mida_valor|Els valors vàlids oscil·len entre 1 i 100.

Per defecte: 45.| |^|Negreta|0|value_bold|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Color|1|valor_color|Codi de color hexadecimal (p. ex., FF0000).

Per defecte: "" (buit).| |Unitats|<|<|<|<| |<|Unitats (casilla de selecció)|0|unitats_mostra|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Unitats (valor)|1|unitats|Qualsevol valor de cadena.| |^|Posició|0|units_pos|0 - Abans del valor;
1 - Per sobre del valor;
2 - (per defecte) Després del valor;
3 - Per sota del valor.| |^|Mida|0|mida_unitats|Els valors vàlids oscil·len entre 1 i 100.

Per defecte: 35.| |^|Negreta|0|units_bold|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Color|1|unitats_color|Codi de color hexadecimal (p. ex., FF0000).

Per defecte: "" (buit).|

Hora

Els paràmetres següents de configuració avançada s'admeten si Veure és establert a "Hora".

Paràmetre tipus nom
Posició horitzontal 0 value_h_pos
Posició vertical 0 value_v_pos
Mida 0 mida_valor
Negreta 0 value_bold
Color 1 valor_color
Indicador de canvi

Els paràmetres següents de configuració avançada s'admeten si Veure és establert a "Indicador de canvi".

Paràmetre tipus nom
Indicador de canvi ↑ color 1 up_color Codi de color hexadecimal (p. ex., FF0000).

Per defecte: "" (buit).
Indicador de canvi ↓ color 1 down_color Codi de color hexadecimal (p. ex., FF0000).

Per defecte: "" (buit).
Indicador de canvi ↕ color 1 updown_color Codi de color hexadecimal (p. ex., FF0000).

Per defecte: "" (buit).

Exemples

Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny Valor d'element. Per obtindre més informació sobre la configuració d'un tauler, veieu dashboard.create.

Configurar el giny Valor d'element

Configura un giny Valor d'element que mostra el valor de l'element "42266" (disponibilitat de l'agent Zabbix ). A més, visualment afina el giny amb més opcions avançades, fins i tot amb un color de fons dinàmic que canvia en base a l'estat de disponibilitat de l'agent Zabbix.

Petició:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "El meu tauler",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "item",
                               "name": "Item value",
                               "x": 0,
                               "y": 0,
                               "width": 4,
                               "height": 3,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 4,
                                       "name": "itemid",
                                       "value": 42266
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "adv_conf",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "description",
                                       "value": "Agent status"
                                   },
                                   {
                                       "type": 0,
                                       "name": "desc_h_pos",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "desc_v_pos",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "desc_bold",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "desc_color",
                                       "value": "F06291"
                                   },
                                   {
                                       "type": 0,
                                       "name": "value_h_pos",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "value_size",
                                       "value": 25
                                   },
                                   {
                                       "type": 1,
                                       "name": "value_color",
                                       "value": "FFFF00"
                                   },
                                   {
                                       "type": 0,
                                       "name": "units_show",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "time_h_pos",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "time_v_pos",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "time_size",
                                       "value": 10
                                   },
                                   {
                                       "type": 0,
                                       "name": "time_bold",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "time_color",
                                       "value": "9FA8DA"
                                   },
                                   {
                                       "type": 1,
                                       "name": "thresholds.color.0",
                                       "value": "E1E1E1"
                                   },
                                   {
                                       "type": 1,
                                       "name": "thresholds.threshold.0",
                                       "value": "0"
                                   },
                                   {
                                       "type": 1,
                                       "name": "thresholds.color.1",
                                       "value": "D1C4E9"
                                   },
                                   {
                                       "type": 1,
                                       "name": "thresholds.threshold.1",
                                       "value": "1"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Veieu també