Install

npm i @gosquared/logs2

You may need to configure npm with a Github packages token.

Usage

Create with AWS credentials:

const { getLogger } = require('@gosquared/logs2');
const config = {
  aws: {
    region: 'us-east-1',
    accessKeyId,
    secretAccessKey
  }
};

const logGroup = 'test';
const logger = getLogger(logGroup, config);

const message = 'test';
const data = { test: 1 };

logger.log(message, data);

Use AWS credentials from environment:

const { getLogger } = require('@gosquared/logs2');
const logGroup = 'test';
const logger = getLogger(logGroup);

const message = 'test';
const data = { test: 1 };

logger.log(message, data);

Permissions

Grant on IAM role to allow writing to log group:

// replace LOGGROUP with log group name
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogStream",
        "logs:PutLogEvents"
      ],
      "Resource": [
        "arn:aws:logs:*:*:log-group:LOGGROUP",
        "arn:aws:logs:*:*:log-group:LOGGROUP:log-stream:*"
      ]
    }
  ]
}

Shut down

Save pending logs to cloudwatch before exit:

const logs = require('@gosquared/logs2');

async function stop() {
  await logs.stop();
}

Error

Errors are emitted as events:

const events = require('@gosquared/logs2/dist/src/events');
events.on('error', e => {
  console.error(e);
});