Datadog

1Presentación

Datadog es un servicio que permite, en particular, centralizar los logs de tus aplicaciones en una única interfaz. Esto puede ser muy útil cuando tu aplicación web está repartida en varios servidores y se vuelve difícil seguir varios archivos de log simultáneamente.

2Configuración

En el archivo de configuración etc/temma.php, añade el objeto \Temma\LogManagers\Datadog a la directiva logManager.

También debes añadir una configuración extendida x-datadog, con las siguientes claves:

  • url: (obligatoria) URL de conexión a la API de Datadog, según la ubicación que hayas elegido
    • EU: https://http-intake.logs.datadoghq.eu/api/v2/logs
    • US: https://http-intake.logs.datadoghq.com/api/v2/logs
    • US3: https://http-intake.logs.us3.datadoghq.com/api/v2/logs
    • US5: https://http-intake.logs.us5.datadoghq.com/api/v2/logs
    • US1-FED: https://http-intake.logs.ddog-gov.com/api/v2/logs
  • apiKey: (obligatoria) Tu clave de API
  • service: (opcional) Nombre del servicio (sitio web o aplicación) que envía el log

Aquí tienes un ejemplo de configuración: 

<?php

return [
    'application' => [
        'logManager' => '\Temma\LogManagers\Datadog'
    ],
    'x-datadog' => [
        'url'     => 'https://http-intake.logs.datadoghq.eu/api/v2/logs',
        'apiKey'  => '...API_KEY...',
        'service' => 'temma.net',
    ]
];

3Uso

En la interfaz web de Datadog, se recomienda crear dos facetas:

  • TraceId, que contendrá una cadena de cuatro caracteres, que permite identificar los logs provenientes de la misma ejecución.
  • Class, que contendrá la clase de registro del log.

Puedes añadir estas facetas como columnas en la tabla general de monitoreo; esto hará que la lectura del flujo de logs sea más explícita.