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 principals.
|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 giny de tauler objecte de camp per a cada grup d'equips amb un nombre incrementat al nom de la propietat.
Aquest paràmetre no s'admet si es configura el giny en una plantilla. tauler de control.| |<|Grups d'equips (Giny)|1|groupids._reference|En lloc de Grup d'equips ID:ABCDE._hostgroupids - establiu un giny compatible (amb el seu conjunt de paràmetres Reference a "ABCDE") com a font de dades per als grups d'equips.
Aquest paràmetre no s'admet si es configura el giny en un tauler de plantilla.| |Equips|<|3|hostids.0|Equip ID.
Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip amb un nombre incrementat al nom de la propietat. Per a diversos equips, el paràmetre Grups d'equips no s'ha de configurar en absolut 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 en un tauler de plantilla.| |<|Equips (Giny/Tauler)|1|hostids._reference|En lloc d'Equip ID:DASHBOARD.hostids - establiu el Selector Equip com a font de dades per a equips;ABCDE._hostids - estableix un giny compatible (amb el seu paràmetre Reference establert a "ABCDE") com a font de dades per als equips.
Aquest paràmetre no s'admet si es configura el giny en 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 en un tauler de control de plantilla.| |^|Nom de l'etiqueta|1|tags.0.tag|Qualsevol valor de cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
Comportament del paràmetre:
- obligatori si es configura etiquetes d'equips
Aquest paràmetre no s'admet si configurar el giny en un tauler de plantilla.| |^|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 del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació de l'etiqueta.
Paràmetre behavior:
- obligatori si es configura etiquetes d'equips
Aquest paràmetre no s'admet si es configura el giny en un tauler de plantilla.| |^|Valor de l'etiqueta|1|tags.0.value|Qualsevol valor de cadena.
Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.
Comportament del paràmetre:
- obligatori si es configura etiquetes d'equips
Aquest paràmetre no s'admet si configurar el giny en un tauler de plantilla.| |Mostra els equips en manteniment|<|0|manteniment|0 - (per defecte) Desactivat;
1 - Activat.| |Columnes (veieu més avall)|<|<|<|<| |Ordena per|<|0|columna|Valor numèric de la columna de les columnes configurades.| |Ordre|<|0|ordre|2 - (per defecte) N superior;
3 - N. inferior| |Límit de l'equip|<|0|show_lines|Els valors possibles oscil·len entre 1 i 1000.
Per defecte: 10.
Aquest paràmetre no s'admet si es configura el giny en un tauler de plantilla.|
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'article
Els paràmetres següents són compatibles si Data s'estableix a "Valor de l'element".
El primer nombre del nom de propietat Llindars (p. ex. columnsthresholds.0.color.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.0.threshold":"5" → "threshold.0.threshold":"1"; "threshold.1.threshold":"1" → "threshold.1. llindar": "5").
|Paràmetre|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Item|<|1 |columns.0.item|Nom d'element vàlid.
Quan es configura el giny en un tauler de plantilla, només els elements s'hauria de configurar a la plantilla.| |Mostra el valor de l'element com a|<|0|columns.0.display_value_as|0 - (per defecte) Numèric;
1 - Text;
2 - Binari.| |Display|<|0|columns.0.display|1 - (per defecte) Tal com és;
2 - Barra;
3 - Indicadors;
6 - Sparkline.
< br>Comportament del paràmetre:
- admès si Mostra el valor de l'element com a s'estableix en "Numèric"| |Min|<|1|columns.0.min|Qualsevol valor numèric.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a s'estableix en "Numèric" i Mostra s'estableix en "Barra" o "Indicadors" | |Max|<|1|columns.0.max|Qualsevol valor numèric.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a s'estableix en "Numèric" i Mostra s'estableix en "Barra" o "Indicadors" | |Llocs decimals|<|0|columns.0.decimal_places|Els valors possibles oscil·len entre 0 i 10.
Per defecte: 2.
Comportament dels paràmetres:
- admès si Mostra el valor de l'element com a està definit com a "Numèric"| |Sparkline|<|<|<|<| |<|Width|0|columns.0.sparkline.width|Els valors possibles oscil·len entre 0 i 10.
Per defecte: 1.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està establert en "Numèric" i Mostra està establert en "Sparkline"| |^|Fill|0|columns.0.sparkline.fill|Els valors possibles oscil·len entre 0 i 10.
Per defecte: 3.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està establert en "Numèric" i Mostra està establert en "Sparkline"| |^|Color|1|columns.0.sparkline.color|Codi de color hexadecimal (p. ex., FF0000).
Per defecte: 42A5F5.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està definit en "Numèric" i Display s'estableixen a "Sparkline"| |^|Període de temps|1|columns.0.sparkline.time_period._reference|DASHBOARD._timeperiod - estableix el Time period selector com a font de dades;< br>ABCDE._timeperiod - estableix un compatible widget (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 a De i A paràmetres.
Comportament dels paràmetres:
- admès si Mostra el valor de l'element com a està establert en "Numèric" i Mostra és establert a "Sparkline"| |^|From|1|columns.0.sparkline.time_period.from|Cadena de temps vàlida en absolut (AAAA-MM-DD hh:mm:ss) o relatiu sintaxi de temps ('ara', 'ara/d', 'ara/w-1w', etc.).
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està establert en "Numèric" i Mostra està establert en "Sparkline"| |^|To|1|columns.0.sparkline.time_period.to|Cadena de temps vàlida en absolut (AAAA-MM-DD hh:mm:ss) o relatiu sintaxi de temps (ara, ara/d, ara/w-1w, etc.).
Paràmetre behavior:
- supported si Mostra el valor de l'element com a està establert en "Numèric" i Display està establert en "Sparkline" | |^|Dades de l'historial|0|columns.0.sparkline.history|0 - (per defecte) Automàtic;
1 - Historial;
2 - Tendències.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a s'estableix en "Numèric" i Mostra està establert a "Sparkline"| |Llindars|<|<|<|<| |<|Color|1|columnsthresholds.0.color.0|Codi de color hexadecimal (per exemple, FF0000).
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està definit en "Numèric"| |^|Llindar|1|columnsthresholds.0.threshold.0|Qualsevol valor de cadena.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està establert en "Numèric "| |Destacats|<|<|<|<| |<|Color|1|columns.0.highlights.0.color|Codi de color hexadecimal (per exemple, FF0000).
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està definit en "Text"| |^|Patró|1|columns.0.highlights.0.pattern|Qualsevol valor de cadena.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a s'estableix en "Text"| |Mostra la miniatura|<|0|columns.0.show_thumbnail|0 - (per defecte) Desactivat;
1 - Activat.
Comportament del paràmetre:
- admès si Mostra el valor de l'element com a està establert en "Binari"| |Funció d'agregació|<|0|columns.0.aggregate_function|0 - (per defecte) no utilitzat;
1 - mín;
2 - màxim;
3 - mitjana;
4 - comptar;
5 - suma;
6 - primer;
7 - darrer.| |Període de temps|<|1|columns.0.time_period._reference|DASHBOARD._timeperiod - estableix el Time period selector com a font de dades;
ABCDE._timeperiod - estableix un compatible widget (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 a De i A paràmetres.
Comportament del paràmetre:
- admès si la funció d'agregació s'estableix en "mínim", "màx", "mitjana". ", "compte", "suma", "primer", "últim"| |<|From|1|columns.0.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.).
Paràmetre behavior:
- admès si no s'estableix Període de temps i la Funció d'agregació s'estableix en "mínim", "màx", "mitjana", "compte", "suma", "primer", "últim"| |^|To|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.).
Paràmetre behavior:
- admès si no s'estableix Període de temps i la Funció d'agregació s'estableix en "mínim", "màx", "mitjana", "compte", "suma", "primer", "últim"| |Dades de l'historial|<|0|columns.0.history|0 - (per defecte) Automàtic;
1 - Historial;
2 - Tendències.
Comportament dels paràmetres:
- supported si Mostra el valor de l'element com a està establert en "Numèric"| |Referència|<|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., ABCDE o JBPNL). Aquest valor ha de ser únic dins del tauler de control al qual pertany el giny.
Comportament del paràmetre:
- obligatori|
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: