Resumen

Elige una opción de configuración a continuación para comenzar a ingerir tus registros. Si ya estás utilizando un demonio de envío de registros, consulta la documentación dedicada para Rsyslog, Syslog-ng, NXlog, FluentD o Logstash.

Consulta la lista de puntos de conexión de recopilación de registros de Datadog disponibles si deseas enviar tus registros directamente a Datadog.

Nota: Al enviar registros en formato JSON a Datadog, hay un conjunto de atributos reservados que tienen un significado específico dentro de Datadog. Consulta la sección de Atributos Reservados para aprender más.

Configuración

1. Instala el Datadog Agent.
2. Para habilitar la recolección de registros, cambia logs_enabled: false a logs_enabled: true en el archivo de configuración principal de tu Datadog Agent (datadog.yaml). Consulta la documentación de recolección de registros del Datadog Agent para más información y ejemplos.
3. Una vez habilitado, el Datadog Agent puede configurarse para realizar el seguimiento de las últimas líneas de archivos de registro o escuchar registros enviados por UDP/TCP, filtrar registros o eliminar datos sensibles, y agregar registros de varias líneas.

1. Instala el Datadog Agent.
2. Para habilitar la recolección de registros, cambia logs_enabled: false a logs_enabled: true en el archivo de configuración principal de tu Datadog Agent (datadog.yaml). Consulta la documentación de recolección de registros del Datadog Agent para más información y ejemplos.
3. Sigue las instrucciones de instalación de tu lenguaje de aplicación para configurar un registrador y comenzar a generar registros:

Elige un proveedor de contenedor u orquestador y sigue sus instrucciones dedicadas de recolección de registros:

Notas:

• El Datadog Agent puede recolectar registros directamente de stdout/stderr del contenedor sin usar un controlador de registro. Cuando se habilita la verificación de Docker del Datadog Agent, los metadatos del contenedor y del orquestador se agregan automáticamente como etiquetas a sus registros.

• Es posible recopilar registros de todos sus contenedores o solo un subconjunto filtrado por imagen de contenedor, etiqueta o nombre.

• Autodiscovery también se puede utilizar para configurar la recopilación de registros directamente en las etiquetas del contenedor.

• En entornos de Kubernetes, también puede aprovechar la instalación de daemonset.

Utilice el Datadog Forwarder, una función de AWS Lambda que envía registros desde su entorno a Datadog. Para habilitar la recopilación de registros en su entorno sin servidor de AWS, consulte la documentación del Datadog Forwarder.

Seleccione su proveedor de Nube a continuación para ver cómo recopilar automáticamente sus registros y enviarlos a Datadog:

Las integraciones de Datadog y la recopilación de registros están vinculadas. Puede utilizar el archivo de configuración predeterminado de una integración para habilitar procesadores, parseo y facetas dedicados en Datadog. Para comenzar la recopilación de registros con una integración:

1. Seleccione una integración de la página de Integraciones y siga las instrucciones de configuración.
2. Siga las instrucciones de recopilación de registros de la integración. Esta sección cubre cómo descomentar la sección de registros en el archivo conf.yaml de esa integración y configurarlo para su entorno.

Reduzca las tarifas de transferencia de datos

Utilice Cloud Network Monitoring de Datadog para identificar las aplicaciones de mayor rendimiento de su organización. Conéctese a Datadog a través de conexiones privadas soportadas y envíe datos a través de una red privada para evitar Internet público y reducir sus tarifas de transferencia de datos. Después de cambiar a enlaces privados, utilice las herramientas de Cloud Cost Management de Datadog para verificar el impacto y monitorear la reducción en sus costos en la nube.

Para más información, consulte Cómo enviar registros a Datadog mientras reduce las tarifas de transferencia de datos.

Si está desarrollando una integración personalizada de Agente, puede enviar registros programáticamente desde su verificación de Agente utilizando el método send_log. Esto permite que su integración personalizada emita registros junto con métricas, eventos y verificaciones de servicio.

Para aprender cómo enviar registros desde su Agent check personalizada, consulte Agent Integration Log Collection.

Opciones de configuración adicionales

Puntos de conexión de registro

Datadog proporciona puntos de conexión de registro tanto para conexiones cifradas por SSL como para conexiones no cifradas. Utilice el punto de conexión cifrado cuando sea posible. El Datadog Agent utiliza el punto de conexión cifrado para enviar registros a Datadog. Más información está disponible en la documentación de seguridad de Datadog.

Puntos de conexión compatibles

Utilice el menú desplegable selector sitio en el lado derecho de la página para ver los puntos de conexión compatibles por el sitio de Datadog.

Reenvío de registros personalizado

Cualquier proceso personalizado o biblioteca de registro capaz de reenviar registros a través de HTTP puede ser utilizado junto con los registros de Datadog.

Puede enviar registros a la plataforma de Datadog a través de HTTP. Consulte la documentación de la API HTTP de registro de Datadog para comenzar.

Notas:

• La API HTTPS admite registros de tamaños de hasta 1 MB. Sin embargo, para un rendimiento óptimo, se recomienda que un registro individual no sea mayor a 25 K bytes. Si utiliza el Datadog Agent para el registro, está configurado para dividir un registro a 900 kB (900000 bytes).
• Un evento de registro no debe tener más de 100 etiquetas, y cada etiqueta no debe exceder 256 caracteres para un máximo de 10 millones de etiquetas únicas por día.
• Un evento de registro convertido a formato JSON debe contener menos de 256 atributos. Cada una de las claves de esos atributos debe tener menos de 50 caracteres, anidados en menos de 20 niveles sucesivos, y su respectivo valor debe ser menor a 1024 caracteres si se promueve como una faceta.
• Los eventos de registro pueden ser enviados con un timestamp que esté hasta 18 horas en el pasado.

Los eventos de registro que no cumplan con estos límites pueden ser transformados o truncados por el sistema o no indexados si están fuera del rango de tiempo proporcionado. Sin embargo, Datadog intenta preservar la mayor cantidad de datos de usuario posible.

Hay una truncación adicional en los campos que se aplica solo a los registros indexados: el valor se trunca a 75 KiB para el campo de mensaje y 25 KiB para los campos que no son de mensaje. Datadog aún almacena el texto completo, y este permanece visible en las consultas de lista regulares en el Explorador de Registros. Sin embargo, la versión truncada se mostrará al realizar una consulta agrupada, como al agrupar registros por ese campo truncado o realizar operaciones similares que muestren ese campo específico.

Atributos y etiquetas

Los atributos prescriben facetas de registros, que se utilizan para filtrar y buscar en el Explorador de registros. Consulte la documentación dedicada de atributos y alias para obtener una lista de atributos reservados y estándar y aprender cómo soportar una convención de nomenclatura con atributos de registros y alias.

Atributos para trazas de pila

Al registrar trazas de pila, hay atributos específicos que tienen una visualización de interfaz de usuario dedicada dentro de su aplicación Datadog, como el nombre del registrador, el hilo actual, el tipo de error y la traza de pila en sí.

Para habilitar estas funcionalidades, utilice los siguientes nombres de atributos:

Nota: Por defecto, las integraciones de Pipelines intentan reasignar los parámetros de la biblioteca de registro predeterminada a esos atributos específicos y analizar trazas de pila o traceback para extraer automáticamente el error.message y error.kind.

Para más información, consulte la documentación completa de atributos de código fuente.

Próximos pasos

Una vez que los registros son recolectados e ingeridos, están disponibles en Explorador de registros. El Explorador de registros es donde puede buscar, enriquecer y ver alertas sobre sus registros. Consulte la documentación de Log Explorer para comenzar a analizar sus datos de registro, o consulte la documentación adicional de gestión de registros a continuación.

Lectura adicional

Más enlaces, artículos y documentación útiles:

Cómo gestionar archivos de registro utilizando LogrotateBLOG Configuraciones avanzadas de recopilación de registrosDOCUMENTACIÓN Descubre cómo procesar tus registrosDOCUMENTACIÓN Aprende más sobre el parseoDOCUMENTACIÓN Funcionalidad de seguimiento de las últimas líneas en vivo de DatadogDOCUMENTACIÓN Ve cómo explorar tus registrosDOCUMENTACIÓN Registros sin Límites*DOCUMENTACIÓN Configuración Avanzada de RegistrosCENTRO DE APRENDIZAJE Configura la recopilación de registros para una aplicación en contenedoresCENTRO DE APRENDIZAJE