Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Conectarse a una fuente de datos de Loki
La fuente de datos de Loki proporciona acceso a Loki, el sistema de agregación de registros de Grafana.
Añadir la fuente de datos
-
Abre el espacio de trabajo de Grafana y asegúrate de haber iniciado sesión.
-
En el menú lateral, debajo del enlace de configuración, encontrará un enlace de fuentes de datos.
-
pulse el botón Añadir fuente de datos situado en la parte superior.
-
Seleccione Loki de la lista de fuentes de datos.
nota
Si no ve el enlace Fuentes de datos en el menú lateral, significa que su usuario actual no tiene el Admin rol.
| Nombre | Descripción |
|---|---|
Name
|
El nombre de la fuente de datos. Así es como se ve la fuente de datos en los paneles, las consultas y Explore. |
Default
|
La fuente de datos predeterminada significa que se preseleccionará para los nuevos paneles. |
URL
|
La URL de la instancia de Loki; p. ej., http://localhost:3100 Puede ser la URL de un host de Amazon EC2, un Application Load Balancer situado delante de un clúster de Amazon EKS o cualquier otra URL de una instancia de Loki. |
Maximum lines
|
Límite máximo de líneas de registro devueltas por Loki (el valor predeterminado es 1000). Disminuya si su navegador es lento al mostrar los registros en Explore. |
Campos derivados
Puede utilizar la configuración de campos derivados para hacer lo siguiente:
-
Agregue los campos analizados desde el mensaje de registro.
-
Agregue un enlace que utilice el valor del campo.
Puedes usar esta funcionalidad para vincular tu servidor de rastreo directamente desde tus registros, o vincular a una página de perfil de usuario si hay un ID de usuario en la línea de registro. Estos enlaces aparecen en los detalles del registro. Para obtener más información, consulte Etiquetas y campos detectados.
Cada campo derivado consta de lo siguiente:
-
Nombre: se muestra en los detalles del registro como una etiqueta.
-
Regex: patrón de expresiones regulares que se ejecuta en el mensaje de registro y captura parte de él como el valor del nuevo campo. Solo puede contener un grupo de captura único.
-
URL/consulta: si el enlace es externo, introduzca la URL completa del enlace. Si el enlace es un enlace interno, esta entrada sirve como consulta para la fuente de datos de destino. En ambos casos, puede interpolar el valor del campo con
${__value.raw }la macro. -
Enlace interno: seleccione si el enlace es interno o externo. En el caso de un enlace interno, un selector de fuentes de datos le permite seleccionar la fuente de datos de destino. Solo se admiten las fuentes de datos de rastreo.
Puedes usar una sección de depuración para ver qué extraen tus campos y cómo se interpola la URL. Selecciona Mostrar ejemplo de mensaje de registro para mostrar el área de texto en la que puedes introducir un mensaje de registro.
El nuevo campo con el enlace que se muestra en los detalles del registro.
Consulta de registros de
La consulta y visualización de los datos de registro de Loki está disponible a través de Explore y con el panel de registros en las visualizaciones. Seleccione la fuente de datos de Loki y, a continuación, introduzca una consulta de LogQL para mostrar los registros. Para obtener más información sobre LogQL, consulte LogQL.
Registra consultas
Una consulta de registro consta de dos partes: un selector de flujo de registro y una expresión de búsqueda. Por motivos de rendimiento, debe empezar por elegir una etiqueta de registro para un flujo de registro.
El explorador de registros (el botón Etiquetas de registro) situado junto al campo de consulta muestra una lista de etiquetas de los flujos de registro disponibles. Una forma alternativa de escribir una consulta es utilizar la función de cumplimentación automática del campo de consulta. Empiece por escribir un corchete izquierdo { y el menú de autocompletar le sugerirá una lista de etiquetas. Pulse la tecla Intro para ejecutar la consulta.
Una vez obtenido el resultado, el panel de registro muestra una lista de filas de registros y un gráfico de barras en el que el eje x muestra la hora y el eje y muestra la frecuencia/recuento.
Selector de flujo de registro
Para la parte de etiqueta de la expresión de consulta, póngala entre corchetes {} y, a continuación, utilice la sintaxis del valor clave para seleccionar las etiquetas. Las expresiones de etiquetas múltiples se separan con una coma:
{app="mysql",name="mysql-backup"}
Actualmente se admiten los siguientes operadores de coincidencia de etiquetas:
-
=exactamente iguales. -
!=no igual. -
=~coincidencia regular. -
!~no haga coincidir las expresiones regulares.
Ejemplos:
-
{name=~"mysql.+"} -
{name!~"mysql.+"}
Otra forma de añadir un selector de etiquetas es en la sección de tablas. Seleccione Filtro junto a una etiqueta para añadir la etiqueta a la expresión de consulta. Esto funciona incluso para consultas múltiples y añadirá el selector de etiquetas a cada consulta.
Expresiones de búsqueda
Tras escribir el selector de flujos de registro, puede filtrar aún más los resultados escribiendo una expresión de búsqueda. La expresión de búsqueda puede ser solo texto o una expresión regular.
Consultas de ejemplo:
-
{job="mysql"} |= "error" -
{name="kafka"} |~ "tsdb-ops.*io:2003" -
{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"
Los operadores de filtro se pueden encadenar y filtrarán secuencialmente la expresión. Las líneas de registro resultantes satisfarán todos los filtros.
Ejemplo
{job="mysql"} |= "error" !=
"timeout"
Actualmente se admiten los siguientes tipos de filtros:
-
|=la línea contiene una cadena. -
!=la línea no contiene una cadena. -
|~la línea coincide con la expresión regular. -
!~la línea no coincide con la expresión regular.
nota
Para obtener más información sobre LogQL, el lenguaje de consulta de Loki, consulte Loki LogQL
Contexto del registro
Al utilizar una expresión de búsqueda como se detalla anteriormente, ahora puede recuperar el contexto que rodea a los resultados filtrados. Si eliges el Show Context enlace de las filas filtradas, podrás investigar los mensajes de registro que aparecen antes y después del mensaje de registro que te interesa.
Creación de plantillas
En lugar de codificar elementos como el nombre del servidor, la aplicación y el sensor en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puedes usar estos cuadros desplegables para cambiar los datos que se muestran en tu panel de control.
Para obtener más información sobre las plantillas y las variables de plantilla, consulte. Plantillas y variables
Annotations
Puede utilizar cualquier consulta de Loki no métrica como fuente de anotaciones. El contenido del registro se utilizará como texto de anotación y las etiquetas del flujo de registro como etiquetas, por lo que no es necesario realizar ningún mapeo adicional.
