NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1583 most downloaded on Packagist
AWS CloudWatch Handler for Monolog library
Latest stable
v3.0.0
Last release 6 months ago
03 May 2026
Ships unpredictably
gaps range from 9 days to 3.5 years
Most releases are documented
notes for 16 of 26 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
26 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Hi! Long time since the last major.
Hi! Long time since the last major.
In this release I'm dropping support for PHP 7.x and 8.0 — minimum PHP is now 8.1. Monolog 2 is also dropped — minimum is now ^3.0. The handler's write() now takes Monolog\LogRecord instead of an array, and Monolog\Logger::DEBUG (and other) constants are replaced with the Monolog\Level enum (Level::Debug, etc.).
The 9 existing constructor parameters keep their order, names, and defaults — existing Symfony positional arguments: lists and Laravel with/handler_with configs continue to work after the platform upgrades above.
New optional 10th constructor argument $createStream (default true). Set to false when the stream is provisioned out of band (e.g. via Terraform) to skip DescribeLogStreams + CreateLogStream and drop the matching IAM permissions.
Internals: full type coverage (constructor promotion + readonly), PSR-2 → PSR-12, PHPUnit upgraded to ^10.5 || ^11.0, phpstan level 8 added to CI, aws/aws-sdk-php constraint loosened to ^3.0.
Full migration notes: CHANGELOG and the "Migrating from 2.x to 3.x" section in the README.
Thanks to everyone who reported issues and submitted PRs.
Happy logging!
$createStream constructor argument (10th, default true). Set to false to skip DescribeLogStreams + CreateLogStream when the log stream is provisioned out of band (e.g. via Terraform). Lets users drop the matching IAM permissions.readonly for immutable state).phpstan (level 8) runs in CI alongside lint and tests.^10.5 || ^11.0.^8.1.^3.0.Monolog\Logger::DEBUG (or other level constant) usage with Monolog\Level::Debug. The $level constructor argument continues to accept int|string|Level so string values like 'debug' keep working.!php/const Monolog\Logger::WARNING must change to !php/const Monolog\Level::Warning.protected function write(array $record): void must update the signature to protected function write(\Monolog\LogRecord $record): void and access fields via ->property instead of ['key'].arguments: lists and Laravel with/handler_with named-key configs continue to work after the platform upgrades above.Your coding agent can read these notes before it upgrades. Set up the MCP server →
sequenceToken tracking. AWS deprecated this parameter in August 2023 — PutLogEvents ignores it server-side and never throws InvalidSequenceTokenExcept…
flush() method for long-lived workers (Laravel queues, Symfony messenger, PHP-FPM with persistent state). The handler's reset() is also overridden to flush, integrating with Symfony ResettableInterface and Laravel Octane's FlushMonologState. (#95, thanks @DrLuke for #102)CredentialProvider::memoize(). (#103)make build, make test, make matrix) running against PHP 8.2 / 8.3 / 8.4 / 8.5.actions/checkout and actions/upload-artifact (both official) are used..gitattributes excludes dev files from the Composer dist tarball; composer require maxbanton/cwh now ships only LICENSE, README.md, composer.json, and src/Handler/CloudWatch.php (~57% smaller).EVENT_SIZE_LIMIT raised from 256 KB to 1 MB (1,048,550 bytes) to match the current AWS PutLogEvents quota. Messages between 256 KB and 1 MB are now shipped as a single CloudWatch event instead of split. (#101)RPS_LIMIT self-throttle (5 RPS). The library no longer sleeps to artificially cap PutLogEvents calls — the AWS quota is 5,000 TPS per account/region (1000× higher), and the AWS SDK's retry middleware handles real throttling automatically. (#111, #114)sequenceToken tracking. AWS deprecated this parameter in August 2023 — PutLogEvents ignores it server-side and never throws InvalidSequenceTokenException or DataAlreadyAcceptedException anymore. (thanks @a10waveracer for #115)CloudWatchLogsException loop in flushBuffer() (it existed solely to refresh the sequence token, which no longer matters).checkThrottle() had a latent bug — $current->diff($savedTime)->s reads only the seconds component of a DateInterval, misbehaving across minute boundaries. Fixed by removing the method entirely (see "Removed" above).flush() and overrides reset() to flush. Existing constructor and method signatures are unchanged; existing ^2.0 pins continue to work without modification.^7.2 || ^8 / monolog/monolog: ^2.0). CI tests PHP 8.2 – 8.5; no code paths require newer PHP.Nothing published for this version
Thanks to jackwakefield for his pr https://github.com/maxbanton/cwh/pull/107
Thanks to jackwakefield for his pr https://github.com/maxbanton/cwh/pull/107
Allow to install on PHP8 CI fixes
Allow to install on PHP8 CI fixes
Nothing published for this version
Hi! It's been a while since last big release. For this time library reached about 1.1M of downloads, which is impressive for me. In this release I'm d
Hi! It's been a while since last big release. For this time library reached about 1.1M of downloads, which is impressive for me. In this release I'm dropped support of PHP 5.* and now minimal required version of PHP is 7.2. Also required version of Monolog library now is ^2.0. A lot of small cosmetic changes was also done, such as migration to Github Actions and cleanup of unneeded files.
Thanks to all who opened an issues and PRs.
Happy coding and Happy New Year!
Thanks @guillaumesmo for the PR https://github.com/maxbanton/cwh/pull/75
Thanks @guillaumesmo for the PR https://github.com/maxbanton/cwh/pull/75
New release with PRs from @mhdhaddad and @KiNgMaR merged
New release with PRs from @mhdhaddad and @KiNgMaR merged
Nothing published for this version
Thanks @holtkamp for contribution!
Thanks @holtkamp for contribution!
Thanks @mstovice for the PR https://github.com/maxbanton/cwh/pull/56
Thanks @mstovice for the PR https://github.com/maxbanton/cwh/pull/56
merged PR https://github.com/maxbanton/cwh/pull/50 thanks to @amandas-sukionis
Thanks for @joshbernfeld for his PR https://github.com/maxbanton/cwh/pull/48
Thanks for @joshbernfeld for his PR https://github.com/maxbanton/cwh/pull/48
thanks to @mstovicek for making Handler compatible with FingersCrossedHandler
Fix issue described here https://github.com/maxbanton/cwh/issues/32#issuecomment-376509885
Fix issue described here https://github.com/maxbanton/cwh/issues/32#issuecomment-376509885
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing special, just one PR merged, minor changes and libraries updated
Nothing special, just one PR merged, minor changes and libraries updated
Nothing published for this version
Handler was completely rewritten with focus for native support of batch log entries sending. Some back incompatible changes done.
Handler was completely rewritten with focus for native support of batch log entries sending. Some back incompatible changes done.
Nothing published for this version
Added functionality which allows batch log processing, thanks to @chris-lu. Some cosmetic changes in addition.
Added functionality which allows batch log processing, thanks to @chris-lu. Some cosmetic changes in addition.
Nothing published for this version
One column per quarter.