Cualquier registro de texto

Convierte Custom Logs en tablas consultables.

Algunos registros los escribe software que solo usa tu empresa. Indica dónde empieza un registro, qué gramática utiliza, dónde está la marca de tiempo y cómo se llaman las columnas —una sola vez— y se convertirá en una tabla como cualquier otra.

Usa los resultados en Excel, Google Sheets, herramientas de IA y tus aplicaciones mediante Database REST API.

Todos los tipos de conectores están disponibles en el plan gratuito. Empieza con 2 fuentes de datos y 1 agente.

Registros personalizadosLos archivos se leen donde se encuentran
Dentro de tu redAgente de red de flujos de consulta

Lee, organiza y consulta en tu máquina.

Consultas de solo lectura · conexión saliente

Los archivos de origen permanecen en su sitio. Tus herramientas reciben los resultados de las consultas.

Origen → agente → resultados permitidos

Query Streams lee cualquier registro de texto, incluidos los que escribe software que solo usa tu empresa, y convierte la carpeta en una tabla SQL activa, accesible desde Microsoft Excel, Google Sheets, asistentes de IA mediante MCP, REST API y Power BI. Describes el formato una sola vez —límite de registro, gramática, marca de tiempo, columnas y rotación— y, a partir de entonces, el agent mantiene fija esa descripción. Hay seis gramáticas disponibles: delimitada, clave = valor, grok, líneas JSON, una directiva de encabezado #Fields y ancho fijo. Las líneas que no coincidan con la descripción se conservan como filas sin procesar en lugar de descartarse, así que un formato imprevisto no te cuesta nada.

  • Seis gramáticas, una sola descripción
  • Las líneas que no coinciden se conservan, nunca se descartan
  • No se envía nada a ningún sitio para su interpretación

Conecta Custom Logs con la configuración adecuada.

Mantén la conexión en el Network Agent. Estos son los detalles específicos de Custom Logs.

Carpeta
Cualquier carpeta de registros de texto: disco local o recurso compartido de red indicado como \\server\share (nunca una letra de unidad asignada; en Linux o Mac, primero debe estar montado); incluye las subcarpetas y admite patrones de inclusión y exclusión
Gramáticas
Delimitada, clave = valor, grok, líneas JSON, una directiva de encabezado #Fields y ancho fijo
Límite del registro
Tú decides: una línea por registro o un patrón, un número fijo, una línea en blanco o un marcador; así, los registros de varias líneas permanecen completos
Marcas de tiempo
Se describen la posición y el formato; si la línea no incluye el año, se puede obtener de la fecha de modificación del archivo's o de su nombre
Rotación
Diez patrones de rotación con nombre, además de archivos sin rotar; los archivos comprimidos se leen directamente
Líneas no coincidentes
Se conservan literalmente en events_raw_lines; nunca se descartan
Credenciales
Ninguno: no hay servidor; el agente lee los archivos en su ubicación

Este es el único perfil de registros que puedes editar, y esa es precisamente la idea: nosotros fijamos todos los demás para que no puedan desviarse. La contrapartida es que no se puede demostrar de antemano que una descripción personalizada sea correcta, como sí ocurre con un perfil incluido de serie. Lo que lo sustituye es la vista previa, que aplica tu descripción a tus propios archivos y te muestra las filas antes de confirmar nada.

Diseñado para el funcionamiento de Custom Logs.

Las cinco partes de un formato

Un perfil bloqueado fija estos valores por ti. Custom expone los cinco, y juntos constituyen toda la descripción: no hay nada más que configurar ni nada oculto.

  • Límite del registro: dónde termina un registro y comienza el siguiente; esto es lo que mantiene una traza de pila de varias líneas en una sola fila.
  • Gramática: delimitado, clave = valor, grok, líneas JSON, una directiva de encabezado #Fields o ancho fijo.
  • Marca de tiempo: dónde está y cómo se escribe, incluido de dónde se obtiene el año cuando la línea lo omite.
  • Columnas: cómo se llama cada campo y de qué tipo es, para que los números se ordenen como números y las fechas se filtren como fechas.
  • Modelo de crecimiento: cómo crece y rota el archivo, para que el archivo histórico de ayer y el archivo activo de hoy formen una sola tabla.
-- Da igual cómo hayas llamado a las columnas: esto es simplemente SQL
SELECT   file_name, severity, COUNT(*) AS lines
FROM     fileset.events
WHERE    severity IN ('WARN','ERROR')
GROUP BY file_name, severity
ORDER BY lines DESC

Prueba primero los formatos integrados

Test connection compara lo que encuentra con los perfiles incluidos de serie y ofrece el más parecido. Esto es una coincidencia de huellas, no un modelo que lea tus registros: no se envía a ningún sitio información de tus archivos para interpretarla. Si hay un perfil integrado que encaja, úsalo: mantener un perfil fijado requiere menos trabajo que mantener una descripción propia. Descríbelo tú mismo si ninguno encaja, y pídenos que incluyamos un perfil si prefieres tener uno.

Los formatos y el comportamiento, en detalle.

Abre la referencia que necesites para Custom Logs.

Si es un archivo de texto, puede ser una tabla.
La gran idea

Si es un archivo de texto, puede ser una tabla.

Tres archivos con formatos totalmente distintos: uno generado por una aplicación de gestión, otro por un trabajo por lotes y otro por una máquina a la que nadie da soporte desde 2011. Describe cada uno una vez y las columnas que hayas definido serán las que consultes. No hace falta ejecutar ningún recolector, mantener ningún índice ni guardar una segunda copia de los datos.

Carpeta de registrotus archivos
Registro de auditoría de plantaclave=valor
lote-2026-09-10.txtancho fijo
robot.rastreodelimitado

Rotaciones, archivos comprimidos y archivos releídos: todo resuelto

qué-salió-mal.sqlSQL
SELECCIONE nombre_archivo, gravedad,
       contar(*) AS pauta
DESDE   eventos del conjunto de archivos
DONDE  gravedad EN ('ADVERTIR','ERROR')
GRUPO POR nombre_archivo, gravedad
ORDENAR POR pauta DESC
Resultadosus columnas
Nombre del archivogravedadpauta
Registro de auditoría de plantaERROR268
lote-2026-09-10ADVERTIR154
robot.rastreoERROR61
Registro de auditoría de plantaADVERTIR9

Hay un gravedad columna porque dijiste que había una

Cifras ilustrativas: muestran el tipo de resultado, no son una comparativa de rendimiento

Seis maneras de decir qué significa una línea
Gramáticas

Seis maneras de decir qué significa una línea

Casi todos los diarios de texto escritos tienen una de estas seis formas. Encuentra la tuya a continuación; la línea de ejemplo suele ayudarte a identificarla más rápido que leer la descripción.

Gramáticas que puedes elegir

6 gramáticas
DelimitadoCSV, TSV, tuberías, cualquier cosa
04:11:07,web-01,ERROR,disco lleno
  • Indica el separador: coma, tabulador, punto y coma, barra vertical o el que use el archivo.
  • Los campos entre comillas se respetan, por lo que una coma dentro de un mensaje permanece dentro de él.
  • Una fila de encabezado puede nombrar las columnas por usted en lugar de escribirlas.
  • El separador decimal lo configuras tú, para los archivos donde es una coma.
Clave = valorpares autodescriptivos
ts=04:11:07 host=web-01 nivel=error
  • Las claves de la línea se convierten en columnas: no tienes que volver a indicarlas.
  • Ambos separadores son suyos: lo que se sitúa entre la clave y el valor, y entre los pares.
  • Se puede omitir un prefijo delante de los pares, como una marca de tiempo o una etiqueta.
  • Común en los registros de aplicaciones y máquinas que se escribieron para ser analizados.
Patrones de GrokPara los más incómodos
%{TIEMPO:ts} %{NIVEL DE REGISTRO:lvl} %{DATOS:msg}
  • Las capturas con nombre se convierten en columnas: el recurso de último recurso cuando nada más encaja.
  • Las bibliotecas de patrones que respaldan los perfiles integrados están ahí para tomar prestados.
  • Se pueden probar varios patrones en orden, para un archivo con más de una forma de línea.
  • El valor predeterminado inicial: uno mensaje columna, luego la estrechas
líneas JSONun objeto por línea
{"ts":"04:11:07","level":"error"}
  • Los campos se convierten en columnas, y usted elige cuáles desea realmente.
  • Un objeto anidado se mantiene intacto como JSON en lugar de aplanarse o eliminarse.
  • Se puede quitar el envoltorio de un entorno de ejecución de contenedores para consultar el registro interno.
  • Lo que escriben la mayoría de las bibliotecas de registro modernas cuando se les indica que estén estructuradas.
Directiva de encabezadoEl archivo nombra sus propias columnas
#Campos: fecha hora s-ip cs-method
  • Una línea cerca de la parte superior declara los campos, y las columnas la siguen.
  • El formato extendido del W3C y cualquier otra cosa que tomara prestada la idea.
  • Tú le pones el nombre a la directiva, así que no hace falta deletrearla. #Campos
  • No hay nada que mantener sincronizado: el archivo es la fuente de la lista de columnas.
Ancho fijocolumnas por posición
20260910041107 web-01 ERROR
  • Asigna a cada columna un nombre, una posición inicial y una longitud: no hace falta ningún separador.
  • La respuesta correcta para archivos donde un campo puede contener el delimitador
  • Sin embargo, lo que escriben los mainframes, los controladores y muchos equipos industriales
  • El relleno se recorta, por lo que un valor no llega envuelto en espacios.
Solicitar un sistema integradosi es un formato que otros también tienen

Describirlo tú mismo es la vía rápida. Si es un formato que utiliza mucha gente, preferimos incluirlo como perfil integrado que el Agent fija para todos: el conector lleva directamente a una solicitud, y el perfil llega con una actualización del Agent.

Conviene aclarar en qué se basa esto. Los perfiles integrados en las demás páginas de registro se crearon y probaron con archivos reales capturados, y así lo indicamos. Este preajuste no se puede — el formato es el que tú describes, así que no hay una estructura fija cuya validez podamos haber demostrado de antemano. Lo que lo sustituye es la vista previa: Test connection aplica tu descripción a tus propios archivos y muestra qué se ha analizado y qué no, antes de que confirmes nada.
Descríbelo una vez y úsalo en todos los lugares donde lo ejecutes.
Cada sitio

Descríbelo una vez, Úsalo en todos los lugares donde corras.

Una descripción forma parte del conector, no de una máquina. Las mismas cinco partes que leen el archivo de auditoría en la sede central también lo leen en la planta y en una segunda región; y cada sitio ejecuta un Network Agent que lee los archivos donde están y se conecta a Query Streams. Para tu firewall, eso es una conexión saliente normal, así que no hay que abrir puertos ni configurar una VPN.

Oficina central Una aplicación empresarial que escribe su propio archivo de auditoría. marca fuera
Planta de tratamiento Un controlador que escribe registros por lotes de ancho fijo marca fuera
eu-oeste La misma aplicación, la misma descripción, una segunda carpeta. marca fuera

Tres conexiones salientes, un único lugar para consultarlas: sin puertos entrantes, sin VPN y sin cambios en el firewall

Tú nombras la identidad

Cada fila indica de dónde procede. De forma predeterminada, se usa el nombre del archivo; si la máquina o el sitio aparece como campo en la línea —o como parte del nombre del archivo—, puedes usarlo como etiqueta y agrupar por él.

nombre del archivo · una columna · parte del nombre del archivo

Nada que abrir

El Agent establece una única conexión saliente cifrada; tanto la solicitud como las filas de respuesta viajan por ella. No hay puertos entrantes, VPN ni cambios en el firewall que solicitar, y tampoco se añade un daemon recopilador a un servidor que ya está ejecutando uno.

una conexión, en ambas direcciones

Una consulta que abarca varias regiones.

Cada fuente en un consulta federada asigna su propio Agent, de modo que una sola instrucción puede colocar un registro personalizado junto a la base de datos que lo explica: el archivo por lotes al lado del pedido al que pertenece. Incluido en Business y Enterprise.

1 registro + 1 base de datos → 1 conjunto de resultados

Escrito una sola vez, no por sitio.

Describir un formato es una tarea que se realiza una sola vez. Una segunda carpeta con la misma estructura es un segundo conector con la misma descripción, por lo que trasladarla a otra ubicación es un paso de configuración, no una investigación adicional.

1 descripción → todas las carpetas similares

Las cuatro preguntas que un archivo de texto no responderá
La parte difícil

Las cuatro preguntas que un archivo de texto no responderá

Analizar la línea es la parte fácil. Estas son las cosas que un archivo de registro no revela sobre sí mismo, y cada una de ellas es algo que usted indica, no algo que nosotros deducimos.

Dónde empieza y termina un disco

Un rastreo de pila representa un evento a lo largo de veinte líneas, y leerlo como veinte eventos resulta en cifras incorrectas. Existen seis maneras de marcar el límite: una línea, un patrón que abre un registro, una línea en blanco, un marcador de apertura y cierre, una regla de continuación o un conteo fijo.

Un registro no siempre es una línea.

La codificación no tiene valores predeterminados.

Este es el único campo que se deja vacío a propósito. Si se presupone UTF-8 en un archivo Latin-1, no se produce ningún error: se alteran silenciosamente todos los caracteres acentuados y no te das cuenta hasta meses después. Por eso se pregunta una sola vez, antes de la primera sincronización, en lugar de hacer una suposición.

elegido, nunca asumido

El año, cuando la línea no tiene ninguna

Muchos formatos muestran el mes y el día, y nada más. Hay tres maneras de determinar el año: aparece en la línea, se obtiene de la fecha de modificación del propio archivo o se extrae del nombre del archivo, que es donde suele guardarse en los archivos históricos fechados.

en la línea · del archivo · del nombre

Nada contó dos veces

Cada archivo se identifica mediante una huella digital de sus primeros 4 KB, de modo que se reconoce un archivo renombrado o rotado en lugar de volver a leerlo desde el principio. Se reconocen por nombre diez patrones de rotación, además de ninguno, para los archivos que simplemente crecen.

Hash del prefijo de 4 KB · ventana de 20 000 registros

Cinco partes, y luego es una tabla.
La descripción

Cinco partes, y luego es una tabla.

Esto es todo lo que tienes que rellenar. Cada perfil integrado de las otras páginas de registros consta de estas mismas cinco partes, completadas por nosotros y fijadas por el Agent; aquí son tuyas.

Límite del registrolo que cuenta como un evento
una líneapatrón de aperturalínea en blancomarcadores de inicio y finregla de continuaciónrecuento fijo
Gramáticacómo se divide un disco
delimitadoclave=valorcomprenderlíneas JSONdirectiva de encabezadoancho fijo
Marca de tiempo¿Qué parte es el tiempo?
campoformatozona horariamodo añocompuesto por dos camposvalores que significan nulo
Columnasnombres y tipos
cadenaenterobigintdoblebooleanomarca de tiempomarca de tiempofechajson
Crecimientocómo cambian los archivos
apéndicespatrón de rotaciónsufijos comprimidosanillo de archivoslongitud máxima de línea
Los valores predeterminados son deliberadamente modestos, y ese es el diseño: uno mensaje una columna por línea, y la hora del evento se toma de la fecha de modificación del archivo. Eso basta para que la primera sincronización se complete correctamente con casi cualquier archivo. Después, puedes ajustar la configuración a partir de la vista previa hasta obtener las columnas que querías. Cada fila también incluye el archivo del que procede, y todo se guarda en una sola tabla, eventos del conjunto de archivos.
Lo que esto deliberadamente no hace

Lo que esto deliberadamente no hace

Di primero el más importante: Pruebe los perfiles integrados antes de recurrir a esto.. Ejecuta Test connection y el Agent te ofrecerá el perfil integrado más parecido que reconozca. El Agent fija los perfiles integrados, que se han probado con archivos reales; una descripción que hayas escrito esta tarde, no. Este ajuste preestablecido es la opción de reserva para formatos que nadie más utiliza, no el punto de partida predeterminado.

Ningún sistema lee tus registros para deducir el formato. La sugerencia de la coincidencia más cercana compara la estructura de tu archivo con los perfiles incluidos: busca patrones en formatos conocidos, no utiliza un modelo que lea tus datos. Si ninguno coincide, tendrás que escribir la descripción y comprobarla en la vista previa.

No se trata de una lectura en tiempo real. Query Streams lee los archivos tal como están en el disco al ejecutar la consulta, por lo que un trabajo fallido se muestra como filas en lugar de como un flujo que se puede observar. Si necesita alertas en fracciones de segundo sobre una línea a medida que se imprime, una canalización de registros es la herramienta adecuada.

Lee texto, y solo texto. Los archivos comprimidos y las bases de datos binarias de la carpeta — .cremallera, .taxi, como un archivo de diario sin procesar, se dejan intactos en lugar de abrirlos e intentar adivinar su contenido. Se leen las rotaciones comprimidas de un registro de texto; no se lee un contenedor que incluya otro tipo de contenido.

La descripción puede ser incorrecta, por lo que no se descarta nada. Una línea cuya gramática no coincide se conserva como una fila sin formato con una explicación adjunta, de modo que el error se muestra y se puede consultar, en lugar de ser un espacio en blanco. Corrija la descripción y vuelva a sincronizar. El resto sigue el diseño habitual: el agente se conecta y lee archivos, no se instala nada en el servidor, no se escribe nada y el acceso es de solo lectura.

De la conexión a resultados útiles.

  1. Instala Network Agent donde tenga acceso a la carpeta y dirige el conector hacia allí.
  2. Ejecuta primero Test connection. El agente crea una huella digital de lo que encuentra y ofrece el perfil integrado más parecido; si alguno encaja, selecciónalo y no tendrás que describir nada.
  3. Si ninguno encaja, describe tú mismo el formato: dónde empieza un registro, cuál de las seis gramáticas utiliza, dónde está la marca de tiempo y qué nombres asignar a las columnas.
  4. Elige el patrón de rotación y, para los formatos cuyas marcas de tiempo no incluyen el año, indica de dónde debe obtenerse. A continuación, esa descripción queda fijada.
  5. Consúltala. La tabla funciona exactamente igual que la de cualquier otro conector de registros', porque utiliza el mismo controlador, que lee un formato que has proporcionado en lugar de uno que hayamos incluido.

Saca partido a los resultados de Custom Logs.

Una conexión sirve a tus hojas de cálculo, aplicaciones y herramientas de IA. Comparte el permiso para ejecutar una consulta guardada; los destinatarios ven los resultados permitidos, con el SQL y el inicio de sesión de origen ocultos.

Para su equipo, proveedores y socios

Importa resultados en tiempo real de Custom Logs directamente en una hoja de cálculo y actualízalos cuando quieras: en Excel de escritorio, Excel Online y Microsoft 365.

Explorar Excel

Haz una pregunta en lenguaje sencillo. Nova ya conoce tus tablas de Custom Logs, escribe y ejecuta el SQL, explica la respuesta y la representa en un gráfico: no tienes que escribir consultas ni compartir credenciales.

Cómo funciona Nova

Comparte un resultado en tiempo real de Custom Logs con quien quieras —un compañero, un proveedor o un socio— mediante una cuadrícula con enlace que se puede guardar en favoritos y que vuelve a ejecutar la consulta para mostrar datos actualizados al abrirse, en un móvil, una tableta o un ordenador. Verán los resultados, nunca el SQL ni los archivos.

Cómo funciona el visor de datos

Para aplicaciones y sistemas

Publica una consulta de Custom Logs como un endpoint JSON autenticado al que puede llamar cualquier aplicación, con una especificación OpenAPI 3.1 y colecciones listas para usar de Postman, Insomnia y Hoppscotch. No se abre ningún puerto de base de datos.

Explorar REST API

Pega el código M de Power Query generado en el Editor avanzado de Power BI y el informe leerá en directo los resultados de Custom Logs a través de HTTPS: no se necesita ningún controlador ODBC ni se abre ningún puerto de base de datos.

Explorar Power BI

Envía los resultados de Custom Logs a una cuadrícula de Smartsheet para que los planes y los informes lean los datos del sistema de origen, no los de la exportación de la semana pasada.

Explora Smartsheet

Conecta una aplicación de Anvil escrita en Python a Custom Logs mediante el endpoint REST, en lugar de incluir credenciales de base de datos en la aplicación.

Explora Anvil

Para herramientas de IA

Entregado a las personas

Combina Custom Logs con el resto de tus datos.

Reúne bases de datos, API empresariales, archivos y registros en una sola consulta de solo lectura. Todos los conectores admiten consultas federadas.

Indica los nombres de las conexiones y las tablas. Query Streams se encarga de las consultas de origen y combina los resultados.

Explorar consultas federadas
Consulta ilustrativa entre fuentes
-- nada copiado, nada fusionado, nada programado
SELECCIONE   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
DESDE     customlogs.fileset.orders1 f
ÚNASE A     pg_crm.clientes.públicos2   c ON c.id = f.customer_id
ÚNASE A     facturación.stripe.facturas3   i ON i.cliente = c.stripe_id
GRUPO POR región c
ORDENAR POR facturado DESC;

Usa tus propios nombres de conexión, esquema, tabla y columna.

Compartido por toda la familia de conectores.

Cada conector de registros también te ofrece

  • events: una fila por cada línea analizada, con la marca de tiempo, los campos definidos por la gramática y _source_file, que indica el nombre del archivo de origen.
  • events_raw_lines: líneas que no coinciden con la gramática, conservadas tal cual en lugar de descartarse, para que puedas seguir respondiendo preguntas sobre formatos que no habías previsto.
  • files_current y files_events: el inventario actual y el registro de auditoría; qué apareció, qué rotó, qué desapareció y qué se retuvo, junto con el nombre del archivo y el motivo.
  • La rotación se reconoce; no se esquiva: hay diez patrones de rotación con nombre y también archivos sin rotar, así que el registro de ayer y su archivo comprimido forman la misma tabla que los de hoy.

Es bueno saberlo

  • Solo lectura, garantizado: una instrucción cada vez, únicamente SELECT y otras similares. Nunca escribimos, movemos, rotamos ni truncamos tus registros.
  • No se carga nada: las líneas se analizan y se guardan en caché, cifradas, en tu propio equipo junto al agente. Solo el resultado de una consulta sale de tu red.
  • Solo se leen los bytes nuevos: el agente retoma la lectura donde la dejó en cada archivo, en lugar de volver a leerlo, para que un registro con mucha actividad no te cueste más cada día.
  • El dialecto SQL es DuckDB: el mismo SQL que escribirías para cualquier otro conector.

Preguntas sobre Custom Logs

¿Dónde puedo usar los resultados de las consultas de Custom Logs?

Usa los resultados de Custom Logs en Excel, Google Sheets, el Visor de datos, tus aplicaciones a través de la API REST de la base de datos y herramientas de IA mediante MCP o Nova. Los resultados guardados también alimentan los destinos de Automation compatibles, los informes y las alertas. La disponibilidad de los destinos y los límites dependen de tu plan.

¿Tengo que abrir un puerto de entrada para Custom Logs?

No. Instala Network Agent en una máquina que pueda acceder a Custom Logs. El agente se conecta hacia fuera a Query Streams; no se necesita ningún puerto de entrada ni VPN. La fuente debe permitir que la máquina del agente se conecte, de acuerdo con sus propias reglas de acceso.

¿Se cargan mis archivos de Custom Logs?

Network Agent lee los archivos donde están y guarda su caché en la máquina del agente. Los archivos de origen no se cargan, se mueven ni se reescriben. Solo los resultados de las consultas solicitadas salen de tu red a través de la conexión cifrada saliente.

¿Qué necesito para conectar Custom Logs?

Carpeta: cualquier carpeta de registros de texto, en un disco local o en un recurso compartido de red especificado como \\server\share (nunca una letra de unidad asignada; en Linux o Mac, primero debe estar montado); incluye subcarpetas y admite patrones de inclusión y exclusión. Gramáticas: delimitado, clave = valor, grok, líneas JSON, una directiva de encabezado #Fields y ancho fijo. Límite de registro: lo defines tú; una línea por registro o un patrón, un número fijo de líneas, una línea en blanco o un marcador, para que los registros de varias líneas permanezcan completos. Marcas de tiempo: se especifican la posición y el formato; cuando la línea no incluye el año, puede tomarse de la fecha de modificación del archivo o de su nombre.

¿Puedo combinar Custom Logs con otras fuentes conectadas?

Sí. Las consultas federadas son compatibles con todos los tipos de conectores, incluidas bases de datos, API empresariales, archivos y registros. Indica las conexiones y tablas en una sola consulta de solo lectura. Query Streams traduce las partes de origen según sea necesario y combina sus resultados. Descubre cómo funcionan las consultas federadas.

¿Cuándo debo usar esto en lugar de un perfil integrado?

Cuando ninguna otra opción encaja. Los perfiles integrados cubren controladores de máquinas, servidores web, contenedores, marcos de aplicaciones y registros del sistema, y cada uno se ha creado y probado con archivos reales. Así que, si tu registro es de uno de esos tipos, elegirlo requiere menos trabajo y está mejor probado que describirlo tú mismo.

Realiza una prueba de conexión antes de decidir. El agente compara la estructura de tu archivo con los perfiles predefinidos y te ofrece el que mejor se ajusta a sus características, por lo que la respuesta se basa en tus archivos reales y no en una suposición. Si no obtienes ninguna respuesta, solicita una descripción.

¿Necesito saber expresiones regulares?

Por lo general, no. Cinco de las seis gramáticas no necesitan ningún patrón: un archivo delimitado necesita un separador, un archivo clave=valor se describe a sí mismo, las líneas JSON se describen a sí mismas, una directiva de encabezado nombra sus propias columnas y el ancho fijo necesita un inicio y una longitud por columna.

Grok es la sexta opción y sirve de salida para las líneas realmente complicadas. Incluso entonces, en general solo tienes que combinar piezas con nombre —una marca de tiempo, un nivel y el resto—; además, puedes aprovechar las bibliotecas de patrones que respaldan los perfiles integrados, en lugar de empezar desde cero.

¿Tengo que escribir la descripción correctamente a la primera?

No, y los valores predeterminados están configurados para que no tengas que hacerlo. De forma predeterminada, una primera sincronización se realiza correctamente en casi cualquier archivo de texto: uno mensaje una columna por línea, con la hora del evento tomada de la fecha de modificación del archivo. Así obtienes una tabla funcional que puedes consultar.

A partir de ahí, puedes perfeccionarla. La vista previa muestra cómo afecta tu descripción a tus propias líneas, para que puedas extraer una gravedad o un número de trabajo en una columna propia y ver el resultado antes de confirmarlo. Cámbiala más adelante y vuelve a sincronizar: mientras tanto, no se habrá descartado nada.

Mis eventos abarcan varias líneas. ¿Puede manejar un rastreo de pila?

Sí, y este es el ajuste que más suele necesitar la gente. Un registro no tiene por qué ser una línea: puedes indicar que empieza cada vez que una línea coincide con un patrón —lo habitual es una marca de tiempo en el margen izquierdo— y que todo lo que viene después pertenece a ese registro hasta la siguiente coincidencia.

Existen otras cinco formas de trazar el límite si esa no es la forma deseada: una línea en blanco entre registros, un marcador de apertura y cierre, una regla para determinar qué se considera una línea de continuación o un número fijo de líneas. Una excepción de veinte líneas se presenta entonces como una sola fila que contiene todo el rastro.

¿Qué ocurre si las líneas no tienen ninguna marca de tiempo?

Ese es el caso predeterminado y funciona. Si no se especifica ningún campo como hora, la hora del evento se toma de la fecha de modificación del archivo; así, las filas se ordenan y siguen respetando un periodo de retención, aunque la hora sea precisa para el archivo y no para cada línea.

Si la hora aparece en la línea, pero está repartida en dos campos —una columna de fecha y otra de hora, algo habitual en archivos de ancho fijo y delimitados—, puedes especificar ambos para combinarlos en una sola marca de tiempo.

¿Qué codificación debo elegir?

UTF-8 es la respuesta correcta para la mayoría de los archivos escritos en esta década. Es el único campo sin valor predeterminado, y esto es intencional: asumir que UTF-8 en un archivo Latin-1 no genera un error, distorsiona silenciosamente cada carácter acentuado, y una corrupción silenciosa es mucho peor que una pregunta formulada una sola vez.

Si no estás seguro, la vista previa te lo indicará: una codificación incorrecta se muestra inmediatamente como texto ilegible en las filas de muestra. El software antiguo de Windows y los equipos industriales suelen ser los motivos por los que la respuesta no es UTF-8.

¿Podrías simplemente añadir mi formato como una función integrada?

Pregúntanos. Si es un formato que utiliza un número razonable de personas —un producto comercial, un framework común o un equipo industrial—, preferimos incluirlo como perfil integrado a que cada cliente tenga que describir lo mismo. El conector enlaza directamente a una solicitud.

Una solución integrada es mejor tanto para usted como para nosotros: está integrada en el Agente, probada con capturas reales y llega a sus servidores con una actualización del Agente, en lugar de requerir que nadie toque un conector.

¿Qué ocurre con las líneas que no coinciden?

Se conservan, no se eliminan. Una línea cuya gramática no coincide se mantiene como una fila sin formato con una explicación adjunta, de modo que una entrada extraña, un formato que cambió bajo tu supervisión o una descripción que aún no es del todo correcta aparece como algo que puedes ver y consultar, en lugar de como un hueco silencioso en tus números.

Esa es la red de seguridad que hace razonable perfeccionar una descripción. Nunca tienes que elegir entre un analizador estricto que descarta datos y uno permisivo que te ofrece un muro de texto: las filas analizadas tienen tipos y todo lo que no se haya podido analizar sigue estando ahí, junto a ellas.

Pon Custom Logs donde se realiza el trabajo.

Empieza con el plan Free: todos los tipos de conectores, 2 fuentes de datos y 1 Network Agent. Amplía las prestaciones incluidas en tu plan a medida que crezcan tus necesidades.