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. # Conexión a un origen de datos de Loki El origen de datos de Loki proporciona acceso a Loki, el sistema de agregación de registros de Grafana. ## Adición del origen de datos 1. Abra el espacio de trabajo de Grafana y asegúrese de haber iniciado sesión. 1. En el menú lateral, bajo el vínculo **Configuración**, encontrará el enlace **Orígenes de datos**. 1. Elija el botón **Agregar origen de datos** en la parte superior. 1. Seleccione **Loki** en la lista de orígenes de datos. **nota** Si no ve el enlace **Orígenes de datos** en el menú lateral, su usuario actual no tiene el rol `Admin`. | Name | Description (Descripción) | | --- | --- | | Name | El nombre del origen de datos. Así es como se ve el origen de datos en los paneles, las consultas y Explore. | | Default | El origen de datos predeterminado significa que se preseleccionará para los nuevos paneles. | | URL | La URL de la instancia de Loki, por ejemplo, http://localhost:3100. Puede ser la URL de un EC2 host de Amazon, una Application Load Balancer situada 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 que devuelve Loki (el valor predeterminado es 1000). Disminuya si el navegador está 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 del mensaje de registro. + Agregue un enlace que utilice el valor del campo. Puede utilizar esta funcionalidad para vincular el backend de seguimiento directamente desde los registros, o enlazar 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](explore.md#labels-and-detected-fields). Cada campo derivado consta de los elementos siguientes: + **Nombre**: se muestra en los detalles del registro como una etiqueta. + **Expresión regular**: patrón de expresión regular que se ejecuta en el mensaje de registro y captura parte de él como el valor del nuevo campo. Solo puede contener un único grupo de captura. + **URL/consulta**: si el enlace es externo, ingrese la URL completa del enlace. Si el enlace es interno, esta entrada sirve como consulta para el origen de datos de destino. En ambos casos, puede interpolar el valor del campo con la macro `${__value.raw }`. + **Enlace interno**: selecciónelo si el enlace es interno o externo. En el caso de un vínculo interno, un selector de orígenes de datos le permite seleccionar el origen de datos de destino. Solo se admiten los orígenes de datos de seguimiento. Puede utilizar una sección de depuración para ver qué extraen los campos y cómo se interpola la URL. Seleccione **Mostrar mensaje de registro de ejemplo** para mostrar el área de texto en la que puede 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 el origen de datos de Loki y, a continuación, ingrese una consulta de LogQL para mostrar los registros. Para obtener más información acerca de LogQL, consulte [LogQL](https://grafana.com/docs/loki/latest/logql/). ### Consultas de registros Una consulta de registros 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 las 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, en el panel de registros se muestra una lista de filas de registros y un gráfico de barras en el que el eje X muestra el tiempo y el eje Y muestra la frecuencia o el recuento. ### Selector de flujo de registro En el caso de la parte de la etiqueta de la expresión de consultas, póngala entre corchetes `{}` y, luego, utilice la sintaxis de valor de clave para seleccionar las etiquetas. Cuando hay varias expresiones de etiquetas, estas se separan con una coma: `{app="mysql",name="mysql-backup"}` Actualmente, se admiten los siguientes operadores de coincidencia de etiquetas: + `=` es exactamente igual. + `!=` no es igual. + `=~` coincidencia de expresión regular. + `!~` no hace coincidir las expresiones regulares. Ejemplos: + `{name=~"mysql.+"}` + `{name!~"mysql.+"}` En la sección de tablas se puede agregar también un selector de etiquetas. Elija **Filtro** junto a una etiqueta para agregar la etiqueta a la expresión de consulta. Esto funciona incluso para varias consultas y agregará el selector de etiquetas a cada consulta. ### Expresiones de búsqueda Después de escribir el selector del flujo de registro, puede filtrar aún más los resultados al escribir 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 filtro: + `|=` 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](https://grafana.com/docs/loki/latest/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 elige el enlace de `Show Context` de las filas filtradas, podrá investigar los mensajes de registro que aparecen antes y después del mensaje de registro que le interesa. ## 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. Puede usar estos cuadros desplegables para cambiar los datos que se muestran en su panel de control. Para obtener más información acerca de las plantillas y sus variables, consulte [Plantillas y variables](templates-and-variables.md). ## Anotaciones Puede utilizar cualquier consulta de Loki no métrica como origen 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 hacer ninguna otra asignación.