PHP download

Download the PHP package shadowbane/laravel-datadog-logger without Composer

On this page you can find all versions of the php package shadowbane/laravel-datadog-logger. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download shadowbane/laravel-datadog-logger
More information about shadowbane/laravel-datadog-logger
Files in shadowbane/laravel-datadog-logger

Vendor shadowbane
Package laravel-datadog-logger
Short Description Custom laravel monolog logger for datadog logs management, both api and agent ways
License MIT
Homepage https://github.com/shadowbane/laravel-datadog-logger

Keywords log php api monolog logger formatter management laravel handler Agent DataDog datadogagent datadoglog datadog-logger

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of shadowbane/laravel-datadog-logger

Informations about the package laravel-datadog-logger

Laravel DataDog Logger

A custom Laravel Monolog logger for sending logs to DataDog via their HTTP API.

Features

Send Laravel logs directly to DataDog via HTTP API
Automatic exception tracking with stack traces
Custom log context support
Configurable log levels and endpoints
Error reporting for failed API requests
Environment-based tagging

Requirements

PHP ^8.1 || ^8.2 || ^8.3 || ^8.4
Laravel 10.x or higher
ext-json
ext-curl
Guzzle ^6.0 || ^7.0
Monolog ^3.0

Installation

Install the package via Composer:

The service provider will be automatically registered.

Configuration

Environment Variables

Add the following to your .env file:

Configuration Options

Variable	Description	Default
`DATADOG_API_KEY`	Your DataDog API key (required)	-
`DATADOG_LEVEL`	Minimum log level (debug, info, notice, warning, error, critical, alert, emergency)	`warning`
`DATADOG_BUBBLE`	Whether logs should bubble to other handlers	`true`
`DATADOG_ENVIRONMENT`	Environment tag for DataDog	Laravel's `app()->environment()`
`DATADOG_API_ENDPOINT`	DataDog logs API endpoint	`https://http-intake.logs.datadoghq.com/api/v2/logs`
`DATADOG_ERROR_LOG_CHANNEL`	Laravel log channel for logging DataDog API failures	`false`

Laravel Logging Configuration

The package automatically merges the datadog-api channel into your logging configuration. You can use it in your config/logging.php:

Usage

Basic Logging

Use the datadog-api channel to send logs to DataDog:

Exception Logging

When logging exceptions, pass the exception in the context array with the key exception:

The logger will automatically extract:

Exception class name (becomes the message)
Error code (error.kind)
Error message (error.message)
Stack trace (error.stack)

Log Context

All context data (except exception, message, and messages) is sent to DataDog as custom attributes:

This will create a log in DataDog with custom attributes: memory_used, memory_limit, and server.

Testing

Test your DataDog integration using the included Artisan command:

This command sends a test exception to DataDog with sample context data.

Log Level Mapping

Laravel log levels are mapped to DataDog status levels:

Laravel Level	DataDog Status
debug, info	info
notice, warning	warn
error, critical, alert, emergency	error

Error Handling

If the DataDog API request fails, you can configure a fallback Laravel log channel to capture these errors:

Failed API requests will be logged to this channel with the Guzzle exception details.

DataDog Log Structure

Logs sent to DataDog include the following fields:

ddsource: Always set to laravel
ddtags: Environment tag (e.g., env:production)
hostname: Server hostname
message: Formatted log message (or exception class name)
service: Your Laravel application name (from config('app.name'))
status: Mapped log level (info, warn, error)
timestamp: Log timestamp in milliseconds
Custom attributes from log context

For exceptions:

error.kind: Exception code
error.message: Exception message
error.stack: Exception stack trace

Development

Static Analysis

Run PHPStan for static analysis:

License

This package is open-sourced software licensed under the MIT license.

Credits

Shadowbane

Support

If you discover any issues, please open an issue on the GitHub repository.

All versions of laravel-datadog-logger with dependencies

PHP Build Version

Package Version

Version v1.2.0 Release 07. Oct 2025
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of laravel-datadog-logger from vendor shadowbane

Requires php Version ^8.1 || ^8.2 || ^8.3 || ^8.4
ext-json Version *
guzzlehttp/guzzle Version ^6.0 || ^7.0
monolog/monolog Version ^3.0

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package shadowbane/laravel-datadog-logger contains the following files

Loading the files please wait ...