AWS CloudWatch Logging for Neos Flow

This package integrates AWS CloudWatch log streams into a Neos Flow application. It is based on Flowpack.Monolog, adapted to publish log records to AWS CloudWatch Logs.

Created by 3m5.de - The Neos Agency

Installation

composer require 3m5/neos-cloud-watch

Configuration

To send your Flow logs to an AWS CloudWatch log stream, configure a handler with the following settings:

• group – name of the AWS CloudWatch Logs log group.
• stream – name of the AWS CloudWatch Logs log stream.
• batchSize – number of log records published to CloudWatch in a single call. Defaults to 10000.
• logLevel – minimum log level for this handler. Defaults to INFO if not set. See Monolog's documentation for the list of possible values.

Example configuration for the systemLogger:

Neos:
  Flow:
    log:
      psr3:
        loggerFactory: 'DMF\CloudWatch\LoggerFactory'
        'DMF\CloudWatch\LoggerFactory':
          systemLogger:
            cloudWatch:
              handler:
                batchSize: <BATCH_SIZE>
                group: <LOG_GROUP>
                stream: <LOG_STREAM>

Creating a CloudWatch log stream

If the log group or stream doesn't exist yet, you can create it with:

./flow logstream:create --logGroupName <LogGroup> --logStreamName <LogStream>

Authentication

This package does not implement its own AWS authentication. It relies on AWS Identity and Access Management (IAM) roles being configured for the environment it runs in.