7 Geomapa
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de panel permiten configurar el widget Geomap 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 Geomap, 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 Geomap.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Host groups | 2 | groupids.0 | ID del Host group. Nota: Para configurar varios host groups, cree un objeto de campo de widget del dashboard para cada host group con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Host groups (Widget) | 1 | groupids._reference | En lugar del ID de Host group:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como origen de datos para los host groups.Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Hosts | 3 | hostids.0 | ID de Host. Nota: Para configurar varios hosts, cree un objeto de campo de widget del dashboard para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro Host groups debe no estar configurado en absoluto o debe estar configurado con al menos un host group al que pertenezcan los hosts configurados. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | En lugar del ID de Host:DASHBOARD.hostids - establezca el selector Host como origen de datos para los hosts;ABCDE._hostids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como origen de datos para los hosts.Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Tags | ||||
| Evaluation type | 0 | evaltype | 0 - (predeterminado) Y/O; 2 - O. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Tag name | 1 | 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 Tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Operator | 0 | tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No es 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 Tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Tag value | 1 | 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 Tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Initial view | 1 | default_view | latitude, longitude y zoom level separados por comas (opcional, los valores posibles van de 0 a 30). Ejemplo: 40.6892494,-74.0466891,10. |
|
| Reference | 1 | reference | Cualquier valor de cadena compuesto por 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del dashboard 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 Geomap.
Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Geomap
Configure un widget Geomap que muestre equipos de los grupos de equipos "2" y "22" según la siguiente configuración de etiquetas: la etiqueta con el nombre "component" contiene el valor "node", y la etiqueta con el nombre "location" es igual al valor "New York". Además, establezca la vista inicial del mapa en las coordenadas "40.6892494" (latitud), "-74.0466891" (longitud) con el nivel de zoom "10".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "geomap",
"name": "Geomap",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 22
},
{
"type": 2,
"name": "groupids.1",
"value": 2
},
{
"type": 1,
"name": "default_view",
"value": "40.6892494,-74.0466891,10"
},
{
"type": 0,
"name": "evaltype",
"value": 2
},
{
"type": 1,
"name": "tags.0.tag",
"value": "component"
},
{
"type": 0,
"name": "tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "tags.0.value",
"value": "node"
},
{
"type": 1,
"name": "tags.1.tag",
"value": "location"
},
{
"type": 0,
"name": "tags.1.operator",
"value": 1
},
{
"type": 1,
"name": "tags.1.value",
"value": "New York"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}