Antes de empezar

Para configurar el widget Geomap, necesitas información de localización en tus datos. La ubicación puede proporcionarse como coordenadas geográficas o como un identificador de ubicación compatible.

Puedes pasar información de localización utilizando cualquiera de las siguientes opciones:

• Opción 1: Incluir los campos de latitud y longitud en cada registro

  Puede utilizar directamente los campos de latitud y longitud para configurar el widget Geomap.

  Los campos deben contener valores de coordenadas numéricas válidos.

• Opción 2: Incluya un campo que contenga un valor de dirección IP y utilice la función de enriquecimiento geográfico

  Debe configurar el enriquecimiento geográfico en el campo IP correspondiente. El enriquecimiento geográfico obtiene valores numéricos de latitud y longitud a partir de direcciones IP y proporciona una fuente coherente de datos de localización para Geomap. Para más información, consulte Configuración de enriquecimientos geográficos.

Para configurar el widget, los campos de latitud y longitud deben ajustarse a cualquiera de los formatos admitidos:

Los datos que se visualizan a través de un widget de Geomapa se agrupan por coordenadas de latitud y longitud en clusters. Piense en un clúster como un cubo virtual de datos que tienen en común la latitud y la longitud.

La consulta que se configura en un widget de Geomap evalúa sólo los 2.000 registros más recientes del intervalo de tiempo seleccionado. Si algunos de esos registros no contienen campos geográficos, se excluyen del mapa, lo que puede dar lugar a una vista vacía o poco poblada. Para asegurarse de que los registros evaluados contienen datos geográficos, debe filtrar explícitamente los campos de ubicación no nulos en el generador de consultas del widget.

Por ejemplo, puede utilizar una consulta dataprime que filtre los registros que no incluyan campos geográficos:

source logs
| filter $d.latitude != null
| filter $d.longitude != null
xxxxx

Ten en cuenta la siguiente información cuando interactúes con el mapa:

• Al acercar o alejar el zoom se cambia el nivel de agregación geográfica, lo que permite pasar de patrones regionales de alto nivel a ubicaciones más granulares.
• Al pasar el ratón por encima de puntos o agrupaciones, aparece una información sobre herramientas con información contextual basada en la configuración actual.
• Al hacer clic en una agrupación, se profundiza en agrupaciones geográficas más pequeñas, lo que facilita la investigación de zonas con valores mixtos o agregados.

Paso 1: Introducir nombre y descripción

Complete los pasossiguientes:

1. En salpicadero personalizado, haga clic en Añadir widget y arrastre y suelte el widget Geomap desde su barra lateral.

2. Sustituya Nuevo geomapa por el nombre del widget.

3. Escriba una descripción.

   Haga clic en Icono de acción . A continuación, seleccione Añadir descripción.

Paso 2: Configurar la consulta para definir el conjunto de datos

Complete los pasossiguientes:

1. Haga clic en Icono de acción . A continuación, seleccione el modo Edición.

2. Para Query 1, siga estos pasos:

   Seleccione el tipo de datos. Los valores válidos son: Logs, Metrics, y DataPrime.

   Selecciona la fuente. Las opciones válidas son: Priority Insights y Analyze and Alert.

   Puede cambiar el nombre de la consulta. Seleccione el y, a continuación, haga clic en Renombrar consulta.

3. Introduzca la consulta.

   Cuando el tipo de datos es DataPrime, introduzca una consulta Dataprime en el campo Consulta.

   Si el tipo de datos es Logs, introduzca una consulta Lucene en el campo Consulta. Puede aplicar filtros y agregaciones.

   Cuando el tipo de datos es Metrics, especifique la métrica o PromQL deseada en el campo Consulta. Puede aplicar filtros y agregaciones.

4. [Opcional] Añade uno o más filtros específicos al widget para limitar los datos que se muestran en tu indicador.

   Seleccione una etiqueta y su valor correspondiente.

   Los filtros se aplican a nivel de widget y funcionan junto con los filtros del cuadro de mandos. En caso de conflicto, los filtros del cuadro de mandos tienen prioridad sobre los filtros de los widgets.

5. Añade una función para agrupar y agregar tus datos para el Geomapa.

Paso 3: Configurar el widget

Complete los pasossiguientes:

1. Haga clic en Icono de acción . A continuación, seleccione el modo Edición.

2. En la sección Gestión de localizaciones > Coordenadas, seleccione los campos a utilizar que contienen la información de latitud y longitud.

   Los campos que contienen valores de latitud y longitud no pueden ser de tipo cadena.

   Sólo puede configurar 1 campo para proporcionar la información de latitud y 1 campo para proporcionar la información de longitud por widget.

   Si sus datos geográficos están disponibles a través de diferentes campos en diferentes registros, utilice reglas de análisis sintáctico para consolidar los datos en uno solo.

   El widget Geomap no detecta ni infiere automáticamente los campos de ubicación. Debe seleccionar explícitamente los campos utilizados para la resolución de ubicación.

3. En Gestión de ubicaciones > Cálculo de valores de cl uster, seleccione cómo se calculan los valores para cada cluster geográfico. Si selecciona un cálculo numérico, Sum, Average, Minimum o Maximum, debe seleccionar un campo numérico en Por campo que se utilizará para calcular los datos que van a un grupo de cluster.

   Los valores válidos son: Count, Sum, Average, Minimum o Maximum.

   Los valores de un cluster se recalculan dinámicamente al acercar y alejar el mapa.

   El zoom aumenta la granularidad, revelando grupos más pequeños o puntos individuales.

   Al alejar el zoom, los clusters cercanos se agregan en agrupaciones de nivel superior.

   Los cálculos basados en el volumen, que utilizan Count o Sum, acumulan valores a medida que los grupos se fusionan.

   Los cálculos basados en el valor, que utilizan Average, Minimum o Maximum, se recalculan a partir de los datos subyacentes.

   Los cálculos de agregación numérica, mediante Sum, Average, Minimum o Maximum, requieren la presencia de un campo numérico en los resultados de la consulta.

   Los resultados sin un valor numérico válido se excluyen de la agregación.

   Si un valor numérico se almacena como una cadena en los datos, es posible que tenga que convertirlo a un tipo numérico en la consulta o analizarlo en la ingesta antes de utilizarlo con agregaciones numéricas. Esto garantiza que el valor pueda incluirse en los cálculos de Sum, Average, Minimum o Maximum.

   Se excluyen los resultados de las consultas que no pueden resolverse en una ubicación geográfica.

   Count cuenta el número de eventos dentro de cada grupo geográfico. Puede utilizar count para identificar puntos conflictivos, concentraciones de tráfico o regiones con elevados volúmenes de errores. Al alejar el zoom, se suman los recuentos de los grupos más pequeños.

   Sum añade los valores de un campo numérico para todos los eventos de cada cluster. Puede utilizarlo para métricas acumulativas como el total de bytes, el total de peticiones o el coste total. Cuando se aleja el zoom, las sumas se suman a través de los grupos.

   Average calcula el valor medio de un campo numérico por cluster. Puede utilizarlo para métricas de rendimiento como la latencia o la duración. Al alejar el zoom, las medias se recalculan a partir de los conglomerados subyacentes, no se suman.

   Minimum o Maximum muestra el valor más bajo o más alto observado dentro de cada conglomerado. Puede utilizar estas opciones para identificar los valores del mejor y del peor caso, los valores atípicos o los picos. Cuando se aleja el zoom, el mínimo o el máximo se recalcula a través de los conglomerados fusionados.

4. En la sección de gestión de información sobre herramientas, personalice la información que aparece al pasar el ratón por encima de un punto o grupo del mapa. Añada el mensaje y seleccione las etiquetas o atributos que desea incluir en la información sobre herramientas.

   Añade el mensaje o valor que se muestra al pasar el ratón por encima de un punto o cluster. Puede hacer referencia a campos dinámicos, como el valor agregado, utilizando la sintaxis {{ }}.

   Cuando un campo referenciado se resuelve con varios valores distintos dentro de un clúster, la información sobre herramientas muestra una etiqueta genérica como "múltiple" en lugar de un valor específico. Esto indica que el conglomerado contiene valores mixtos y anima a profundizar para obtener más detalles.

   Seleccione qué etiquetas o atributos incluir en la información sobre herramientas, como servicio, aplicación o país.

5. En la sección Gestión visual, defina cómo se representan los valores en el mapa.

   Las opciones válidas son Size y Color range.

   Elija Tamaño para el análisis basado en el volumen, en el que el volumen y la concentración son las señales principales.

   Elija la gama Color para un análisis centrado en el rendimiento. Puede seleccionar una paleta de colores y controlar cómo se asignan los valores a los colores. Puede definir umbrales para controlar cómo se traducen los valores de los clústeres en colores. Los umbrales se evalúan en función del cálculo del valor de cluster seleccionado y se actualizan dinámicamente a medida que cambian los valores de cluster.

Paso 4: Guardar el widget

Complete los pasossiguientes:

1. [Opcional] Establezca la hora del salpicadero del widget si desea utilizar un intervalo de tiempo distinto del seleccionado en el salpicadero.

2. Haz clic en Guardar para guardar tu widget.

3. [Opcional] Añadir una acción personalizada. Para obtener más información, consulte Uso de acciones para integrarse con servicios de terceros.

Acciones en un mapa

Utiliza acciones rápidas para investigar datos directamente desde el mapa.

Al seleccionar un punto o un cluster, un menú contextual ofrece las siguientes acciones:

• Open Explore: Abre los registros en la vista Explorar, prefiltrados utilizando la ubicación y el contexto de clúster seleccionados.

• Filter in: Añade la ubicación seleccionada y el contexto de valores a la consulta del cuadro de mandos.

• Filter out: Excluye la ubicación y el contexto de valores seleccionados de la consulta del cuadro de mandos.

• Copy name: Copia la etiqueta de localización o el par clave=valor asociado al punto o cluster seleccionado.