serverless-plugin-woodchuck

Serverless plugin for automatic JSON log forwarding to cloud-based log management tools.

Features

Supported Runtimes:

• nodejs14.x
• nodejs12.x
• nodejs10.x
• python3.7
• python2.7
• dotnet6.0
• dotnetcore3.1
• dotnetcore2.1
• go1.x
• java11
• java8.al2
• java8
• ruby2.7
• ruby2.5

Supported Log Destinations:

• Loggly
• Logz.io

Install

Serverless

serverless plugin install --name serverless-plugin-woodchuck

Manually

yarn add --dev serverless-plugin-woodchuck
# or
npm install -D serverless-plugin-woodchuck

Add the following plugin to your serverless.yml:

plugins:
  - serverless-plugin-woodchuck

Add the relevant config for your logging platform:

Loggly Example Configuration:

custom:
  woodchuck:
    destination: "loggly"
    config: 
      token: <loggly-token>
      tag: <loggly-tag>

Logzio Example Configuration:

custom:
  woodchuck:
    destination: "logzio"
    config: 
      token: <logzio-token>
      host: <logzio-host> # these are usually like: "listener.logz.io"

For more information on Woodchuck and configuring look at its repo

Excluding functions

The exclude array can be used to exclude the Woodchuck layer from a function.

In this example only "functionA" function will have the Woodchuck lambda layer.

functions:
  functionA:
    handler: handler.handler
    events:
      - http:
          method: get
          path: a
  functionB:
    handler: handler.handler
    events:
      - http:
          method: get
          path: b

custom:
  woodchuck:
    exclude:
      - functionB