Custom handler for PHP logging library Monolog

Uses AWS CloudWatch Log services

Before using this library, it's recommended to get acquainted with the pricing for AWS CloudWatch services

Code Quality Rank: L4
Monthly Downloads: 50,096
Programming language: PHP
License: MIT License
Tags: Logging     API     Aws     CloudWatch     Logs     Monolog    
Latest version: v2.0.1

CWH (CloudWatch Handler) alternatives and similar libraries

Based on the "Logging" category

Do you think we are missing an alternative of CWH (CloudWatch Handler) or a related project?

Add another 'Logging' Library


AWS CloudWatch Logs Handler for Monolog

Actions Status Coverage Status License Version Downloads

Handler for PHP logging library Monolog for sending log entries to AWS CloudWatch Logs service.

Before using this library, it's recommended to get acquainted with the pricing for AWS CloudWatch services.

Please press ★ Star button if you find this library useful.



  • Up to 10000 batch logs sending in order to avoid Rate exceeded errors
  • Log Groups creating with tags
  • AWS CloudWatch Logs staff lazy loading
  • Suitable for web applications and for long-living CLI daemons and workers


Install the latest version with Composer by running

$ composer require maxbanton/cwh:^2.0

Basic Usage


use Aws\CloudWatchLogs\CloudWatchLogsClient;
use Maxbanton\Cwh\Handler\CloudWatch;
use Monolog\Logger;
use Monolog\Formatter\JsonFormatter;

$sdkParams = [
    'region' => 'eu-west-1',
    'version' => 'latest',
    'credentials' => [
        'key' => 'your AWS key',
        'secret' => 'your AWS secret',
        'token' => 'your AWS session token', // token is optional

// Instantiate AWS SDK CloudWatch Logs Client
$client = new CloudWatchLogsClient($sdkParams);

// Log group name, will be created if none
$groupName = 'php-logtest';

// Log stream name, will be created if none
$streamName = 'ec2-instance-1';

// Days to keep logs, 14 by default. Set to `null` to allow indefinite retention.
$retentionDays = 30;

// Instantiate handler (tags are optional)
$handler = new CloudWatch($client, $groupName, $streamName, $retentionDays, 10000, ['my-awesome-tag' => 'tag-value']);

// Optionally set the JsonFormatter to be able to access your log messages in a structured way
$handler->setFormatter(new JsonFormatter());

// Create a log channel
$log = new Logger('name');

// Set handler

// Add records to the log

Frameworks integration

And many others

AWS IAM needed permissions

if you prefer to use a separate programmatic IAM user (recommended) or want to define a policy, make sure following permissions are included:

  1. CreateLogGroup aws docs
  2. CreateLogStream aws docs
  3. PutLogEvents aws docs
  4. PutRetentionPolicy aws docs
  5. DescribeLogStreams aws docs
  6. DescribeLogGroups aws docs

When setting the $createGroup argument to false, permissions DescribeLogGroups and CreateLogGroup can be omitted

AWS IAM Policy full json example

    "Version": "2012-10-17",
    "Statement": [
            "Effect": "Allow",
            "Action": "logs:CreateLogGroup",
            "Resource": "*"
            "Effect": "Allow",
            "Action": [
            "Resource": "{LOG_GROUP_ARN}"
            "Effect": "Allow",
            "Action": [
            "Resource": [


Feel free to report any issues


Please check this document

Made in Ukraine πŸ‡ΊπŸ‡¦

*Note that all licence references and agreements mentioned in the CWH (CloudWatch Handler) README section above are relevant to that project's source code only.