Documentation
Table of Contents
16 Navegador de métricas
Descripción
Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Navegador de métricas en los métodos dashboard.create y dashboard.update.
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero. 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 que se describen en las tablas siguientes.
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 - (predeterminado) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.| |Grupos de equipos|<|2|groupids.0|ID de Grupo de equipos.
Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de tablero para cada grupo de equipos con un número incrementado en el nombre de la propiedad.
Este parámetro no se admite si se configura el widget en una plantilla de tablero.| |<|Grupos de equipos (Widget)|1|groupids._reference|En lugar del ID de Grupo de equipos:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para grupos de equipos.
Este parámetro no se admite si se configura el widget en un tablero de una plantilla.| |Equipos|<|3|hostids.0|ID de equipo.
Nota: Para configurar varios equipos, cree un objeto de campo de widget de tablero para cada equipo con un número incrementado en el nombre de la propiedad. Para varios equipos, el parámetro Grupos de equipos no debe estar configurado en absoluto o configurarse con al menos un grupo de equipos al que pertenecen los equipos configurados.
Este parámetro no se admite si se configura el widget en una plantilla de tablero.| |<|Equipos (Widget/Dashboard)|1|hostids._reference|En lugar del ID de Equipo:DASHBOARD.hostid - establezca el Selector de equipo como fuente de datos para los equipos;ABCDE._hostid - establece un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los equipos.
Este parámetro no se admite si se configura el widget en un tablero de una plantilla.| |Etiquetas de equipo|<|<|<|<| |<|Tipo de evaluación|0|host_tags_evaltype|0 - (predeterminado) Y/O;
2 - O.
Este parámetro no se admite si se configura el widget en una plantilla de tablero.| |^|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 las etiquetas en la lista de evaluación de etiquetas.
Comportamiento del parámetro:
- obligatorio si se configuran etiquetas de equipo
Este parámetro no se admite si se configura el widget en una [plantilla de tablero] (/manual/api/reference/templatedashboard/object).| |^|Operador|0|host_tags.0.operator|0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.
Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.
Comportamiento del parámetro:
- obligatorio si se configuran Etiquetas de equipo
Este parámetro no se admite si se configura el widget en una plantilla de tablero.| |^|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 las etiquetas en la lista de evaluación de etiquetas.
Comportamiento del parámetro:
- obligatorio si se configuran etiquetas de equipo
Este parámetro no se admite si se configura el widget en una [plantilla de tablero] (/manual/api/reference/templatedashboard/object).| |Patrones de métricas|<|1|items.0|Nombre o patrón de métrica.
Nota: Para configurar varios patrones de métricas, cree un objeto de campo de widget de tablero para cada patrón de métrica con un número incrementado en el nombre de la propiedad.| |Etiquetas de métrica|<|<|<|<| |<|Tipo de evaluación|0|item_tags_evaltype|0 - (predeterminado) 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 las etiquetas en la lista de evaluación de etiquetas.
Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de elementos| |^|Operador|0|item_tags.0.operator|0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.
Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.
Comportamiento del parámetro:
- obligatorio si se configuran Etiquetas de elementos| |^|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 las etiquetas en la lista de evaluación de etiquetas.
Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de elementos| |Estado|<|0|estado|-1 - (predeterminado) Todo;
0 - Normal;
1 - No compatible.| |Mostrar problemas|<|0|show_problems|0 - Todos;
1 - (predeterminado) No suprimido;
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.
< br>Nota: El número en el nombre de la propiedad hace referencia al orden de los atributos en la lista de atributos de agrupación.
Comportamiento del parámetro:
- obligatorio si configurando 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.
<br >Comportamiento del parámetro:
- obligatorio si la configuración de Agrupar por y Atributo se establece en "Valor de etiqueta de host" o "Valor de etiqueta de elemento"| |Límite de métricas|<|0|show_lines|Los valores posibles oscilan entre 1 y 9999.
Predeterminado: 100.| |Referencia|<|1|reference|Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del tablero al que pertenece el widget.
Comportamiento del parámetro:
- requerido|
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Navegador de métrica. Para obtener más información sobre cómo configurar un panel, consulte dashboard.create.
Configuración de un widget Navegador de métrica
Configure un widget Navegador de métrica que muestre hasta 1000 métricas agrupadas por su equipo y, luego, por el valor de la etiqueta de la 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: