aws_cloudwatch 1.1.0

An easy, lightweight, turnkey solution for logging with AWS CloudWatch

1.1.0 - 2025-06-21

• Updated to aws_request ^1.1.0
• Removed outdated lint rule

1.0.1 - 2024-05-20

• Updated to aws_request ^1.0.1

1.0.0 - 2023-05-31

• Requires Dart 3.0 or later
• Updated to aws_request ^1.0.0
• Updated to http ^1.0.0

0.6.0 - 2023-05-31

• Updated to aws_request 0.5.0 to support intl 0.18.0+
• Fixed tests broken by dart update
• Removed deprecated analysis options

0.5.7+2 - 2023-02-09

• Formatted project to comply with new dart formatting rules
• Minor housekeeping to fix running tests & lint deprecations

0.5.7+1 - 2022-09-21

• Updated README and fixed examples

0.5.7 - 2022-09-21

• Updated default message delay to 200ms
• Updated default largeMessageBehavior to split
• Updated documentation

0.5.6+1 - 2022-09-20

• Fixed failing test

0.5.6 - 2022-09-20

• Added timestamped message hash and message number to split messages

0.5.5 - 2022-05-13

• Added response status code to CloudWatchException

0.5.4 - 2022-03-24

• Added explicit types to constructor arguments that were missing them
• Added dynamically adjust timeouts
• Reduced repeated CloudwatchException Timeout errors
• Updated README with details about new features
• Added unit tests

0.5.3 - 2022-02-06

• Reduced repeated failed lookup printout
• Added unit tests
• Fixed 2.10 analyzer errors

0.5.2 - 2022-01-25

• Fixed issue where message bytes exceeded max in rare cases with many small messages
• Added optional arguments
  • maxBytesPerMessage Changes how large each message can be before [largeMessageBehavior] takes effect. Min 5, Max 262116
  • maxBytesPerRequest Changes how many bytes can be sent in each API request before a second request is made.
  • maxMessagesPerRequest Changes the maximum number of messages that can be sent in each API request
• Added special case for timeout exception with detail message & steps forward
• Updated README with info on new optional arguments
• Added special case for InvalidParameterException along with instructions for reporting them

0.5.1 - 2022-01-24

• Updated aws_request version

0.5.0 - 2022-01-20

Breaking Changes:

• Removed setDelay & setLoggingParameters
• Added groupName & streamName as required arguments to CloudWatch
• Changed awsAccessKey & awsSecretKey to named arguments
• Changed CloudWatchHandler.log argument msg to message to be more consistent

General Changes and Fixes

• Refactored entire library to be highly testable
• Added lots of unit tests
• Fixed issue where delay, requestTimeout, and retries could be set negative
• Updated examples to reflect breaking changes
• Added stricter analyzer rules

0.4.7 - 2022-01-10

• Added note about android permissions to readme
• Added coverage
• Updated aws_request to 0.3.0 to resolve issues on web [khurram72]

0.4.6+2 - 2022-01-08

• Updated aws_request version to fix issue related to web requests

0.4.6+1 - 2022-01-06

• Added session tokens to CloudWatch constructor [khurram72] (#8)
• Fixed issue where session token wasn't sent with some requests [khurram72] (#8)

0.4.6 - 2022-01-05

• Added support for AWS temporary credentials with session tokens (#7)
• Set X-Amz-Expires with requestTimeout for improved security
• Fixed some spelling mistakes
• Updated readme with information about using session tokens
• Updated readme example 3 to log errors to different log group

0.4.5 - 2021-12-22

• Fixed issue related to using static logStreamName and logGroupName (#6)

0.4.4 - 2021-10-03

• DNS lookup failures are now silenced by default (raiseFailedLookups flag)
• Added better comments throughout
• Added tests for cloudwatch, handler, and logStack
• Refactored existing tests into different files based on subject
• Added AwsResponse class
• Refactored classes into separate files for better readability
• Updating attributes of a handler now updates its child instances
• Made several more private classes / functions / attributes public for testing
• Reorganized readme and added section for Failed DNS Lookups
• Added toString to CloudWatchException for easier debugging in IDE
• Added better recovery from failed group and stream creation

0.4.3 - 2021-09-20

• Added support for more automatic error recovery
• Made CloudWatchLogStack & CloudWatchLog public classes
• Added tests for CloudWatchLogStack
• Added more debug logs
• Added github CI
• Fixed issue with setLoggingParameters found in tests
• Added CI pipeline badge

0.4.2 - 2021-09-16

• Added ability to recover from InvalidSequenceTokenException
• Updated prepend method to slightly faster one
• Refactored code for better separation and readability
• Removed unneeded flutter dependency to allow native and js compatibility
• Updated README
• Changed to MIT license
• Fixed an error message
• Fixed error in documentation

0.4.1 - 2021-09-16

• Updated documentation to remove references to splitLargeMessages
• Fixed issue where messages smaller than 262118 utf8 bytes were not sent

0.4.0 - 2021-09-15

• Fixed issue with API requests not waiting delay when the log queue backed up
• Added CloudWatchLargeMessages to allow for multiple large message behaviors
• Updated documentation to follow dart conventions and work better with Intellij
• Replaced splitLargeMessages with CloudWatchLargeMessages
• Removed deprecated CloudWatch.withDelay constructor
• Removed deprecated CloudWatchException cause field

0.3.1 - 2021-09-12

• Refactored log stack into its own class for better readability
• Added logGroupName and logStreamName validation
• Added API retries functionality if request fails
• Added splitLargeMessages functionality that automatically resizes out of spec messages
• Improved error handling and recovery. When requests fail logs are now prepended and requeued
• Added checks for AWS limits and adjust how messages are sent accordingly
• Added optional API request timeout parameter
• Updated aws_request version for improved functionality + bugfixes
• Fixed an issue with empty errors being thrown / returned
• Refactored code for better reusability

0.3.0+3 - 2021-08-26

• Updated setDelay to use Duration

0.3.0+2 - 2021-08-26

• Updated readme and example with delay type change
• Updated function comments with updated wording referencing delay parameter

0.3.0+1 - 2021-08-25

• Switched to new aws_cloudwatch version

0.3.0 - 2021-08-25

• Added stack trace to CloudWatchException class
• Fixed area where empty CloudWatchException was created
• Fixed issue with error handling causing uncatchable exception
• Changed delay to a Duration
• Added logMany to both CloudWatch and CloudWatchHandler
• Changed setVerbosity function to private

0.2.0+4 2021/08/3

• Fixed delay from seconds to milliseconds

0.2.0+3 2021/08/3

• Added optimization to reduce lock clutter
• Replaced sleep command with Future.delayed to avoid pausing app

0.2.0+2 - 2021-07-31

• Applied naming fix to CloudWatchHandler instance constructor
• Added test coverage for CloudWatchHandler
• Fixed issue with synonym setters

0.2.0+1 - 2021-07-31

• Fixed naming scheme for optional variables in constructor
• Added groupName and streamName as synonyms for logGroupName and logStreamName

0.2.0 - 2021-07-30

• Added CloudWatchHandler class to easily manage multiple CloudWatch instances
• Added quick start logging example file
• Automatically creates Log Groups that don't exist
• Updated the README with info on CloudWatchHandler and quick start
• Improved code readability
• Updated to new version of aws_request
• Added min 0 delay in place it was missing

0.1.12 - 2021-07-14

• Fixed bug where delay was input in seconds instead of milliseconds

0.1.11 - 2021-07-09

QOL update

• Fully removed optional deprecated xAmzTarget argument from main constructor (deprecated in 0.1.0)
• Added optional arguments for group / stream name to both constructors
• Added missing method setLoggingParameters that was shown in error message when group / stream name was null
• Updated all examples to show different group / stream name instantiations
• Added optional delay argument to main constructor and deprecated withDelay constructor
• Expanded readme

0.1.10 - 2021-07-01

• Added web compatibility
• Moved synchronous calls to synchronized package
• Reformatted code to pass static analysis
• Fixed issue with error catching for HttpExceptions

0.1.9 - 2021-05-19

• Updated aws_request version to fix null safety typing issue
• Fixed issue with aws errors being rethrown incorrectly

0.1.8 - 2021-05-19

• Fixed null safety issue with previous release

0.1.7 - 2021-05-18

• Moved to new version of aws_requests to fix hard coded region bug
• Improved error handling

0.1.6 - 2021-03-26

• Added console output logging with 4 verbosity levels
• Added optional delay parameter to address possible rate limiting
  • Updated readme with new rate limiting example

0.1.5 - 2021-03-26

• Fixed issue with attempted logging before logstream creation finished

0.1.4 - 2021-03-25

• Fixed issue with sending empty logs

0.1.3 - 2021-03-25

• Updated aws_request version to fix unicode error

0.1.2 - 2021-03-24

• Actually migrated to null safety

0.1.1 - 2021-03-23

• Removed two more references to ServiceInstance

0.1.0 - 2021-03-23

• Updated dependencies for null safety
• Put deprecation warning on xAmzTarget (formerly serviceInstance
  • Updated example and docs to reflect changes with xAmzTarget
• Added exception if PutLogEvents returns a status code other than 200

0.0.6 - 2021-03-26

Non-null Safety Update

• Updated examples
• Fixed issue with attempted logging before logstream creation was finished

0.0.5 - 2021-03-25

Non-null Safety Update

• Fixed issue with sending empty logs

0.0.4 - 2021-03-25

Non-null Safety Update

• Put deprecation warning on xAmzTarget (formerly serviceInstance)
  • Updated example and docs to reflect changes with xAmzTarget
• Added exception if PutLogEvents returns a status code other than 200
• Updated aws_request version to fix unicode error

0.0.3 - 2021-02-10

• Updated dependencies

0.0.2 - 2021-02-10

• Added example

0.0.1 - 2021-02-10

• Added initial code for sending logs to cloudwatch