sgoettsch/monolog-datadog

Monolog Handler to forward logs to Datadog using async requests.

3.3.1 2025-02-06 00:26 UTC

Requires

• php: ^8.1
• ext-curl: *
• guzzlehttp/guzzle: ^7.5
• monolog/monolog: ^3.0

Requires (Dev)

• phpunit/phpunit: ^10.0

Suggests

• ext-pcntl: *

MIT

• Sebastian Goettsch

• monolog

README

Monolog Handler to forward logs to Datadog using async requests. Uses pcntl for async logging, will automatically fall back to non async requests if pcntl is not available.

Requirements

• PHP 8.1+
• PHP Curl

Optional

• php-pcntl ( required for async logging )

Installation

composer require sgoettsch/monolog-datadog

Basic Usage

<?php

use Monolog\Logger;
use sgoettsch\MonologDatadog\Handler\DatadogHandler;

$apiKey = 'DATADOG-API-KEY';
$host = 'https://http-intake.logs.datadoghq.com'; // could be set to other domains for example for EU hosted accounts ( https://http-intake.logs.datadoghq.eu )
$attributes = [
    'hostname' => 'YOUR_HOSTNAME',
    'source' => 'php',
    'service' => 'YOUR-SERVICE'
];

$logger = new Logger('datadog-channel');

$datadogLogs = new DatadogHandler($apiKey, $host, $attributes, Monolog\Level::Info);

$logger->pushHandler($datadogLogs);

$logger->info('i am an info');
$logger->warning('i am a warning');
$logger->error('i am an error');
$logger->notice('i am a notice');
$logger->emergency('i am an emergency');