18 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 | valor | |
|---|---|---|---|---|---|
| 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 | ID de l'Element. Comportament del paràmetre: - obligatori |
|
| < | Element (Giny) | 1 | itemid._reference | En lloc de l'id de l'Element:ABCDE._itemid - establiu un giny compatible (amb el seu paràmetre Referència establert a "ABCDE") com a font de dades per als elements.Comportament de la propietat: - obligatori si no s'ha definit Element |
|
| Veure | < | 0 | show.0 | 1 - Descripció; 2 - Valor; 3 - Hora; 4 - Indicador de canvi. Per defecte: 1, 2, 3, 4 (tots activats). Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor. |
|
| Substitueix l'equip | < | 1 | override_hostid._reference | ABCDE._hostid - estableix un giny compatible (amb el seu paràmetre Referència definit en "ABCDE") com a font de dades que conté l'equip.DASHBOARD._hostid - defineix el tauler tria d'Equip com a font de dades que conté l'equip.Aquest paràmetre és no s'admet si es configura el giny en un tauler de plantilla. |
|
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. |
Període de temps | < | 1 | time_period._reference | DASHBOARD._timeperiod - estableix el selector Període de temps com a font de dades.ABCDE._timeperiod: estableix un giny compatible (gràfic, Gràfic (clàssic) o Prototip de gràfic amb el seu paràmetre reference igual a ABCDE) com a font de dades.Valor predeterminat: DASHBOARD._timeperiodCom a alternativa, podeu establir el període de temps només als paràmetres Des de i Fins a.< br> Comportament del paràmetre: - admès si la funció d'agregació s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer" |
< | Des de | 1 | time_period.from | Cadena de temps vàlida en absolut (AAAA-MM-DD hh:mm:ss) o relatiu sintaxi temporal (ara, ara/d, ara/w-1w, etc.).[Comportament del paràmetre](/manual/api/ reference_commentary#parameter-behavior): - admès si no s'estableix Període de temps i la funció d'agregació s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer" |
^ | To | 1 | time_period.to | Cadena de temps vàlida en absolut (AAAA-MM-DD hh:mm:ss) o [relatiu](/manual/web_interface/ time_period_selector) sintaxi temporal (now, now/d, now/w-1w, etc.).Comportament del paràmetre: - admès si el Període de temps no és pas definit i la Funció d'agregació s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer" |
Dades de l'historial | < | 0 | historial | 0 - (per defecte) Automàtic; 1 - Historial; 2 - Tendències. |
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 | valor | |
|---|---|---|---|---|
| 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 possibles 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). |
|
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 | valor | |
|---|---|---|---|---|---|
| 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). |
||
Sparkline
Els següents paràmetres de configuració avançada són compatibles si Mostra està establert a "Sparkline".
| Paràmetre | tipus | nom | valor | |
|---|---|---|---|---|
| Amplada | 0 | sparkline.width | Els valors possibles oscil·len entre 0 i 10. Per defecte: 1. |
|
| Emplenar | 0 | sparkline.fill | Els valors possibles oscil·len entre 0 i 10. Per defecte: 3. |
|
| Color | 1 | sparkline.color | Codi de color hexadecimal (p. ex., FF0000).Per defecte: 42A5F5. |
|
| Període de temps | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod - estableix la tria de Període de temps com a font de dades;ABCDE ._timeperiod - estableix un giny compatible (amb el seu paràmetre reference igual a ABCDE) com a font de dades.Per defecte: DASHBOARD._timeperiod< br>Com alternativa, podeu establir el període de temps només als paràmetres De i A. |
|
| Des de | 1 | sparkline.time_period.from | Cadena de temps vàlida en la sintaxi temporal absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.). |
|
| Fins a | 1 | sparkline.time_period.to | Cadena de temps vàlida en sintaxi de temps absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.). |
|
| Dades de l'historial | 0 | sparkline.history | 0 - (per defecte) Automàtic; 1 - Historial; 2 - Tendències. |
|
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.
{
"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
}