Table of Contents
17 Navegador de métricas
Descripción
Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo de widget de panel permiten configurar el widget Navegador de métricas en los métodos dashboard.create y dashboard.update.
Las propiedades fields del widget no se validan durante la creación o actualización de un panel. Esto permite a los usuarios modificar widgets integrados y crear widgets personalizados, pero también introduce el riesgo de crear o actualizar widgets incorrectamente. Para garantizar la creación o actualización exitosa del widget Navegador de métricas, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Navegador de métricas.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - (por defecto) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Grupos de equipos | 2 | groupids.0 | ID del Grupo de equipos. Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de panel para cada grupo de equipos con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Grupos de equipos (Widget) | 1 | groupids._reference | En lugar del ID del Grupo de equipos:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como la fuente de datos para los grupos de equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Equipos | 3 | hostids.0 | ID del Equipo. Nota: Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo con un número incrementado en el nombre de la propiedad. Para varios equipos, el parámetro Grupos de equipos debe no estar configurado en absoluto o configurado con al menos un grupo de equipos al que pertenezcan los equipos configurados. Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Equipos (Widget/Panel) | 1 | hostids._reference | En lugar del ID del Equipo:DASHBOARD.hostid - establezca el selector de Equipo como la fuente de datos para los equipos;ABCDE._hostid - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como la fuente de datos para los equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Etiquetas de equipo | ||||
| Tipo de evaluación | 0 | host_tags_evaltype | 0 - (por defecto) Y/O; 2 - O. Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Nombre de etiqueta | 1 | host_tags.0.tag | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Operador | 0 | host_tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No igual a; 4 - Existe; 5 - No existe. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Valor de etiqueta | 1 | host_tags.0.value | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Patrones de métricas | 1 | items.0 | Nombre o patrón de la Métrica. Nota: Para configurar varios patrones de métricas, cree un objeto de campo de widget de panel para cada patrón de métrica con un número incrementado en el nombre de la propiedad. |
|
| Etiquetas de métricas | ||||
| Tipo de evaluación | 0 | item_tags_evaltype | 0 - (por defecto) Y/O; 2 - O. |
|
| Nombre de etiqueta | 1 | item_tags.0.tag | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de métricas |
|
| Operador | 0 | item_tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No igual a; 4 - Existe; 5 - No existe. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de métricas |
|
| Valor de etiqueta | 1 | item_tags.0.value | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de métricas |
|
| Estado | 0 | state | -1 - (por defecto) Todos; 0 - Normal; 1 - No soportado. |
|
| Mostrar problemas | 0 | show_problems | 0 - Todos; 1 - (por defecto) No suprimidos; 2 - Ninguno. |
|
| Agrupar por | ||||
| Atributo | 0 | group_by.0.attribute | 0 - Grupo de equipos; 1 - Nombre de equipo; 2 - Valor de etiqueta de equipo; 3 - Valor de etiqueta de métrica. Nota: El número en el nombre de la propiedad hace referencia al orden del atributo en la lista de atributos de agrupación. Comportamiento del parámetro: - obligatorio si se configura Agrupar por |
|
| Valor | 1 | group_by.0.tag_name | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al atributo de agrupación establecido en el parámetro Atributo. Comportamiento del parámetro: - obligatorio si se configura Agrupar por y Atributo está establecido en "Valor de etiqueta de equipo" o "Valor de etiqueta de métrica" |
|
| Límite de métricas | 0 | show_lines | Los valores posibles van de 1-9999. Por defecto: 100. |
|
| Referencia | 1 | reference | Cualquier valor de cadena que consista en 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del panel al que pertenece el widget.Comportamiento del parámetro: - obligatorio |
|
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Navegador de métricas. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Navegador de métricas
Configure un widget Navegador de métricas que muestre hasta 1000 métricas agrupadas por su equipo y, luego, por el valor de la etiqueta de métrica "component".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "itemnavigator",
"name": "Item navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 3
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "component"
},
{
"type": 0,
"name": "show_lines",
"value": 1000
},
{
"type": 1,
"name": "reference",
"value": "DFNLK"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: