Documentation
Table of Contents
26 Equips principals
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 Equips principals 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 Equips principals, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
Paràmetres
Els paràmetres següents són compatibles amb el giny Equips Top.
|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.| |Grups d'equips|<|2|groupids.0|Grup d'equips ID.
Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips amb un nombre incrementat a la propietat del nom.
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |<|Grups d'equips (Giny)|1|groupids._reference|En lloc de l'ID del Grup d'equips ID:ABCDE._hostgroupids - establiu un giny compatible (amb el seu paràmetre Referència establert a "ABCDE") com a font de dades per als grups d'equips.
Aquest paràmetre no és compatible si es configura el giny en un tauler de plantilla.| |Equips|<|3|hostids.0|ID d'equip.
Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre Grups d'equips no s'ha de configurar pas o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |<|Equips (Giny/Tauler)|1|hostids._reference|En lloc d'ID d'Equip:DASHBOARD.hostids - establiu la Tria d'Equip com a font de dades per als equips;ABCDE._hostids - establiu un giny compatible (amb el seu paràmetre Referència establert a "ABCDE") com a font de dades per als equips.
Aquest paràmetre no s'admet si es configura el giny a una plantilla tauler de control.| |Etiquetes d'equips|<|<|<|<| |<|Tipus d'avaluació|0|evaltype|0 - (per defecte) I/O;
2 - O.
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |^|Nom de l'etiqueta|1|tags.0.tag|Qualsevol valor de cadena.
Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.
Comportament del paràmetre:
- obligatori si es són configurant Etiquetes d'equips
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |^|Operador|0|tags.0.operator|0 - Conté;
1 - És igual;
2 - No conté;
3 - No és igual;
4 - Existeix ;
5 - No existeix.
Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.
Comportament del paràmetre:
- obligatori si es són configurant Etiquetes d'equips
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |^|Valor de l'etiqueta|1|tags.0.value|Qualsevol valor de cadena.
Nota: El nombre al nom de la propietat fa referència a l'ordre d'etiqueta del llistat d'avaluació d'etiquetes.
Comportament del paràmetre:
- obligatori si es són configurant Etiquetes d'equips
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.| |Veure els equips en manteniment|<|0|maintenance|0 - (per defecte) Desactivat;
1 - Actiu.| |Columnes (veieu més avall)|<|<|<|<| |Ordenar per|<|0|column|Valor numèric de columna de les columnes configurades.| |Ordre|<|0|order|2 - (per defecte) N superior;
3 - N. inferior| |Límit d'equips|<|0|show_lines|El rang de possibles valors és 1-100.
Default: 10.
Aquest paràmetre no s'admet si es configura el giny a un tauler de plantilles.|
Columnes
Les columnes tenen paràmetres comuns i paràmetres addicionals en funció de la configuració del paràmetre Data.
Per a tots els paràmetres relacionats amb les columnes, el nombre del nom de la propietat (p. ex. columns.0.name) fa referència a una columna per a la qual és configurat el paràmetre.
Els paràmetres següents són compatibles amb totes les columnes.
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Nom | 1 | columns.0.nom | Qualsevol valor de cadena. Comportament del paràmetre: - obligatori |
| Data | 0 | columns.0.data | 1 - Valor de l'element; 2 - Nom de l'equip; 3 - Text. Comportament del paràmetre: - obligatori |
| Color base | 1 | columns.0.base_color | Codi de color hexadecimal (p. ex., FF0000).Comportament del paràmetre: - obligatori |
Valor de l'element
Els paràmetres següents són compatibles si Data s'estableix en "Valor de l'element".
El primer nombre del nom de propietat Llindars (p. ex. columnsthresholds.color.0.0) fa referència a la columna per a la qual es configuren els llindars, mentre que el segon nombre fa referència al lloc llindar en una llista, ordenada 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| |-|--------|--|---------|---------------------------- -----| |Element|<|1 |columns.item.0|Nom d'element vàlid.
Quan es configura el giny a un tauler de plantilla, només es poden establir els elements configurats a la plantilla.| |Visualització|<|0|columns.display.0|1 - (per defecte) Tal com és;
2 - Barra;
3 - Indicadors.| |Min|<|1|columns.min.0|Qualsevol valor numèric.
Comportament del paràmetre behavior:
- admès if Visualització s'estableix a "Barra" o "Indicadors"| |Max|<|1|columns.max.0|Qualsevol valor numèric.
Comportament del paràmetre behavior:
- admès if Visualització s'estableix a "Barra" o "Indicadors"| |Llocs decimals|<|0|columns.decimal_places.0|Els valors vàlids oscil·len entre 0 i 10.
Per defecte: 2.| |Llindars|<|<|<|<| |<|Color|1|columnsthresholds.color.0.0|Codi de color hexadecimal (per exemple, FF0000).
Per defecte: "" (buit).| |^|Llindar|1|columnsthresholds.threshold.0.0|Qualsevol valor de cadena.| |Funció d'agregació|<|0|columns.aggregate_function.0|0 - (per defecte) cap;
1 - mín;
2 - màxim;
3 - mitjana;
4 - recompte;
5 - suma;
6 - primer;
7 - darrer.| |Període de temps|<|1|columns.0.time_period._reference|DASHBOARD._timeperiod - estableix la tria de Període de temps com a font de dades.ABCDE._timeperiod: defineix un giny compatible (Navegador de l'equip amb el seu paràmetre reference igual a ABCDE) com a font de dades.
Per defecte: DASHBOARD._timeperiod
Alternativament, només podeu establir el període de temps als paràmetres Des de i Fins a.
Comportament del paràmetre:
- admès si la Funció d'agregació s'estableix a "min", "max", "mitjana", "recompte", "suma", "primer", "darrer" | |<|Des de|1|columns.0.time_period.from|Cadena de temps vàlida en la sintaxi de temps absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.).
Comportament del paràmetre:
- admès si no s'estableix Període de temps i la Funció d'agregació s'estableix a "min", "max", "mitjana", "recompte", "suma", "primer", "darrer"| |^|Fins a|1|columns.0.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.).
Comportament del paràmetre:
- admès si no s'estableix Període de temps i la Funció d'agregació s'estableix en "min", "max", "mitjana", "recompte", "suma", "primer", "darrer"| |Dades de l'historial|<|0|columns.history.0|1 - (per defecte) Automàtic;
2 - Historial;
3 - Tendències.|
Text
Els paràmetres següents s'admeten si Data s'ha establert a "Text".
| Paràmetre | tipus | nom | valor |
|---|---|---|---|
| Text | 1 | columns.0.text | Qualsevol valor de cadena, incloses les macros. Macros admeses: {HOST.*}, {INVENTORY.*}. Comportament del paràmetre: - obligatori si Data és establert a "Text" |
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 Equips top. Per obtindre més informació sobre la configuració d'un tauler, veieu dashboard.create.
Configurar el giny d'Equips principals
Configurar un giny d'Equips principals que ensenya els principals equips per ús de CPU del grup d'equips "4". A més, configura les següents columnes a mida: "Nom d'equip", "Ús de CPU, en %", "1m avg", "5m avg", "15m avg", "Processos".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: