Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La herramienta Log Analytics de Azure Portal permite ejecutar y editar consultas de registro en los datos del almacén de registros de Azure Monitor. Ofrece dos modos que facilitan la exploración y el análisis de los datos de registro para los usuarios básicos y avanzados:
Modo simple proporciona la funcionalidad de registros de Azure Monitor más usada en una experiencia intuitiva similar a una hoja de cálculo. Simplemente apunte y haga clic para filtrar, ordenar y agregar datos para obtener la información necesaria la mayor parte del tiempo.
El modo KQL proporciona a los usuarios avanzados toda la eficacia del lenguaje de consulta kusto (KQL) para obtener información más detallada de sus registros mediante el editor de consultas de Log Analytics.
Tanto si trabaja con los resultados de las consultas de forma interactiva como si los usa con otras características de Azure Monitor, como las alertas de búsqueda de registros o los libros. Log Analytics es la herramienta que se usa para escribirlas y probarlas.
En este artículo se describe la interfaz de usuario de Log Analytics y sus características. Si quiere ir directamente a un tutorial, consulte Tutorial de Log Analytics.
Vídeo de introducción
Abrir Log Analytics
Para abrir Log Analytics en Azure Portal, seleccione Registros en Azure Monitor, en un área de trabajo de Log Analytics o desde un recurso específico. La herramienta siempre es la misma, pero donde se comienza determina qué datos están disponibles.
Al abrir Registros desde Azure Monitor o áreas de trabajo de Log Analytics, tiene acceso a todos los registros de un área de trabajo. Si selecciona Registros desde otro tipo de recurso, los datos se limitan a los datos de registro de ese recurso. Para obtener más información, consulte Ámbito e intervalo de tiempo de una consulta de registro en Log Analytics de Azure Monitor.
Al iniciar Log Analytics, aparece un cuadro de diálogo que contiene consultas de ejemplo. Las consultas están clasificadas por solución. Examine o busque las consultas que coincidan con sus requisitos. Es posible que encuentre una que haga exactamente lo que necesita. También puede cargar una en el editor y modificarla según sea necesario. Examinar las consultas de ejemplo es una buena manera de aprender a escribir sus propias consultas.
Si quiere empezar con un script vacío y escribirlo usted mismo, cierre las consultas de ejemplo. Si desea acceder de nuevo a las consultas de ejemplo, seleccione Centro de consultas en la parte superior de la pantalla o a través de la barra lateral izquierda.
Interfaz de Log Analytics
En la imagen siguiente se identifican cuatro componentes de Log Analytics en modo sencillo:
Barra de acciones superior
En modo simple, la barra superior tiene controles para trabajar con datos y cambiar al modo KQL.
| Opción | Descripción |
|---|---|
| Intervalo de tiempo | Seleccione el intervalo de tiempo para los datos disponibles para la consulta. En el modo KQL, si establece un intervalo de tiempo diferente en la consulta, se invalida el intervalo de tiempo establecido en el selector de tiempo. |
| Mostrar | Configure el número de entradas que Log Analytics recupera en modo simple. El límite predeterminado es 1000. Para obtener más información sobre los límites de consulta, consulte Configuración del límite de resultados de la consulta. |
| Agregar | Agregue filtros y aplique operadores de modo simple, como se describe en Exploración y análisis de datos en modo simple. |
| Modo Simple/KQL | Cambie entre el modo Simple y KQL. |
Nota:
En modo simple, la barra de acciones superior no incluye un botón Ejecutar . Los resultados se actualizan automáticamente a medida que el usuario refina la consulta.
Barra lateral izquierda
El panel izquierdo contraíble proporciona acceso a tablas, ejemplos y consultas guardadas, funciones e historial de consultas.
Ancle el panel izquierdo para mantenerlo abierto mientras trabaja o maximice la ventana de consulta seleccionando un icono en el panel izquierdo solo cuando lo necesite.
| Opción | Descripción |
|---|---|
| Tablas | Muestra las tablas que forman parte del ámbito seleccionado. Mantenga el puntero sobre un nombre de tabla para ver la descripción de la tabla y un vínculo a su documentación. Expanda una tabla para ver sus columnas. Seleccione una tabla para ejecutar una vista previa en ella. |
| Consultas | Enumera consultas de ejemplo y guardadas. Esta es la misma lista que se encuentra en el centro de consultas. Abra el menú contextual [...] junto a la barra de búsqueda y seleccione Agrupar por para cambiar la agrupación de las consultas. Mantenga el puntero sobre una consulta para ver la descripción de la consulta. Seleccione una consulta para ejecutarla. |
| Funciones | Enumera funciones, que permiten reutilizar la lógica de consulta predefinida en las consultas de registro. |
| Historial de consulta | Enumera el historial de consultas. Seleccione una consulta para volver a ejecutarla. |
Nota:
La vista Tablas no muestra tablas vacías de forma predeterminada.
Para cambiarlo para la sesión actual, abra el menú
...contextual situado junto a la barra de búsqueda y seleccione Mostrar tablas sin datos.Para mostrar u ocultar tablas vacías de forma permanente, abra el menú
...contextual situado encima de la barra de acciones superior, seleccione Configuración de Log Analytics, active Mostrar tablas sin datos y Guarde los cambios.
Historial de consultas
El historial de consultas registra las consultas que ejecutas en un recurso y las deja disponibles para volver a ejecutarlas más adelante. En las secciones siguientes se describe dónde se almacena el historial de consultas, cuánto tiempo se mantiene y qué escenarios no admite.
Almacenamiento regional y delimitación del alcance de los recursos
El historial de consultas está centrado en los recursos y en la región. Log Analytics almacena el historial en la misma región que el recurso que se consulta, lo que ayuda a cumplir los requisitos de residencia de datos y de cumplimiento. Como resultado, el historial que ve depende del recurso y de su región:
- Los recursos regionales, como Log Analytics áreas de trabajo, recursos de Application Insights y máquinas virtuales, almacenan el historial en la propia región del recurso. Dos recursos de regiones diferentes no comparten el historial.
- Recursos globales que no tienen ninguna ruta de región a una región predeterminada fija para la nube. En la nube pública Azure, la región predeterminada es Oeste de Europa.
El ámbito también depende del tipo de recurso. Cada Log Analytics área de trabajo mantiene su propio historial independiente, por lo que el historial del área de trabajo A difiere del historial del área de trabajo B. Para otros tipos de recursos, los recursos del mismo tipo dentro de la misma región comparten un historial común.
Retención y límites
Las pestañas representan el historial de consultas de la sesión actual. En modo simple, se permite una consulta por pestaña.
| Comportamiento | Detalle |
|---|---|
| Retention | El historial se conserva durante 30 días. |
| Límite por usuario | Hasta 300 consultas por usuario, por recurso. |
| Tamaño del texto de consulta | Cada consulta almacenada puede tener hasta 40 KB. Las consultas más grandes no se guardan en el historial. |
Borrar el historial de consultas
Borrar el historial de consultas se aplica a un ámbito completo, por lo que borrar el historial quita todas las consultas de ese ámbito a la vez. En el caso de los tipos de recursos que comparten el historial, borrar el historial afecta a todos los recursos de ese tipo en la misma región.
Escenarios no soportados
El historial de consultas no está disponible en los casos siguientes:
- Almacenamiento administrado por el cliente: el historial de consultas no se admite cuando el área de trabajo usa una cuenta de almacenamiento administrada por el cliente.
- Operaciones de traslado de recursos: el historial de consultas está vinculado al ID original del recurso y no se conserva al mover un área de trabajo a otro grupo de recursos o a otra suscripción. El historial almacenado antes del traslado no es accesible desde el recurso movido.
El historial de consultas almacena el texto completo de cada consulta. Este texto no se registra en la telemetría y no es accesible para los operadores de Microsoft.
Ventana de consulta
Nota:
La ventana de consulta solo está disponible en modo KQL.
La ventana de consulta es donde se edita la consulta. Se utiliza IntelliSense para los comandos KQL y la codificación de colores mejora la legibilidad. Seleccione + en la parte superior de la ventana para abrir otra pestaña.
Una única ventana puede incluir varias consultas. Una consulta no puede incluir líneas en blanco, por lo que puede separar varias consultas en una ventana con una o varias líneas en blanco. La consulta actual es aquella donde el cursor está posicionado en cualquier parte.
Para ejecutar la consulta actual, seleccione el botón Ejecutar o pulse Mayús+Entrar.
Ventana Resultados
Los resultados de una consulta aparecen en la ventana de resultados. De forma predeterminada, los resultados se muestran como una tabla. Para mostrar los resultados como un gráfico, seleccione Gráfico en la ventana de resultados. También puede agregar un comando render a la consulta.
Vista de resultados
La vista de resultados muestra los resultados de la consulta en una tabla organizada por columnas y filas.
- Haga clic a la izquierda de una fila para expandir sus valores.
- Seleccione la lista desplegable Columnas para cambiar la lista de columnas.
- Seleccione el nombre de una columna para ordenar los resultados.
- Seleccione el embudo situado junto a un nombre de columna para filtrar los resultados.
- Ejecute de nuevo la consulta para borrar los filtros y restablecer la ordenación.
- Seleccione Agrupar columnas para mostrar la barra de agrupación sobre los resultados de la consulta.
- Agrupe los resultados por cualquier columna arrastrándolos a la barra.
- Agregue más columnas para crear grupos anidados en los resultados.
Vista de diagrama
La vista de gráfico muestra los resultados en uno de los distintos tipos de gráficos disponibles. Puede especificar el tipo de gráfico en un comando render en la consulta (modo KQL). También puede seleccionarlo desde la sección Formato del gráfico contraíble a la derecha.
| Opción | Descripción |
|---|---|
| Tipo de gráfico | Tipo de gráfico que se va a mostrar. |
| Eje X | Columna de los resultados que se va a usar para el eje X. |
| Eje Y | Columna de los resultados que se va a usar para el eje Y. Normalmente, se trata de una columna numérica. |
| Dividir por | Columna de los resultados que define la serie del gráfico. Se crea una serie para cada valor de la columna. |
| Agregación | Tipo de agregación que se va a realizar en los valores numéricos del eje Y. |
Más herramientas
En esta sección se describen más herramientas disponibles encima del área de resultados de la consulta de la pantalla, como se muestra en la captura de pantalla siguiente. La captura de pantalla se numera entre 1 y 8.
| # | Opción | Descripción |
|---|---|---|
| 1 | Pestaña menú contextual | Desde los puntos suspensivos de una pestaña de consulta, cambiar el ámbito de la consulta o cambiar el nombre, duplicar o cerrar la pestaña. |
| 2 | Agente de observabilidad | Chatear con los datos mediante lenguaje natural para explorar registros, buscar errores comunes, analizar anomalías y exponer información sin escribir KQL. |
| 3 | Guardar | Guardar una consulta en un paquete de consultas o como una función, o anclar la consulta a un libro, un panel de Azure, o panel de Grafana. |
| 4 | Compartir | Copie un vínculo a la consulta, el texto de la consulta o los resultados de la consulta, o bien exportar datos a Excel, CSV o Power BI. |
| 5 | Menú contextual de Herramientas | En los puntos suspensivos del cuadro de búsqueda: Nueva regla - de alertasCree una nueva regla de alertas a partir de la consulta actual. Buscar trabajo - Ejecute un trabajo de búsqueda mediante la consulta actual. Log Analytics configuración: defina la configuración de Log Analytics predeterminada, incluida la zona horaria, si Log Analytics se abre en modo Simple o KQL y si se muestran tablas sin datos. |
| 6 | Centro de consultas | Abra el cuadro de diálogo de consultas de ejemplo que aparece cuando se abre por primera vez Log Analytics. |
| 7 | Autoguardado | Log Analytics guardado automático guarda automáticamente el estado actual de la sesión en el almacenamiento local del navegador. Si el navegador se bloquea, la página se actualiza o sale de ella y vuelve, su trabajo se restaura al volver a abrir Registros del mismo recurso en el mismo navegador. |
| 8 | Columnas | Reordenar, ocultar o mostrar columnas en la tabla de resultados. Activa el modo de tabla dinámica para mostrar la tabla según una o varias columnas. |
Configuración de Log Analytics
En esta captura de pantalla se muestra el cuadro de diálogo de configuración de Log Analytics.
Guardado automático
Log Analytics guarda automáticamente el estado de sesión actual en el almacenamiento local del explorador. Si el navegador se bloquea, la página se actualiza o sale de ella y vuelve, su trabajo se restaura cuando vuelve a abrir Logs para el mismo recurso en el mismo navegador.
El guardado automático conserva el siguiente estado:
- Nombres de pestañas y todas las pestañas de consulta (KQL y Simple)
- Modo de trabajo (Simple o KQL)
- Ámbito de la consulta
- Intervalo de tiempo
- Mostrar la configuración de la píldora
Ámbito y retención del autoguardado
Ámbito: el estado se guarda por explorador y dispositivo y por recurso específico. Retención: el estado guardado se conserva durante 30 días. Después de 30 días de inactividad para un recurso, el estado guardado se elimina automáticamente.
Relación con Azure Data Explorer
Si ya ha trabajado con la interfaz de usuario web de Azure Data Explorer, Log Analytics debe resultarle familiar. Se basa en Azure Data Explorer y usa el mismo lenguaje de consulta kusto.
Log Analytics agrega características específicas a Azure Monitor, como el filtrado por intervalo de tiempo y la capacidad de crear una regla de alertas a partir de una consulta. Ambas herramientas incluyen un explorador que permite examinar la estructura de las tablas disponibles. La interfaz de usuario web de Azure Data Explorer trabaja principalmente con tablas de bases de datos de Azure Data Explorer. Log Analytics trabaja con tablas de un área de trabajo de Log Analytics.
Contenido relacionado
- Explorar un tutorial sobre el uso de Log Analytics en el portal de Azure.
- Recorra un tutorial sobre cómo escribir consultas.
- Vea el vídeo de tutorial más largo reemplazado por el vídeo introducción.