Package Exports

aws-logging
aws-logging/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aws-logging) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

aws-logging

Logs activity across all services under a single AWS account. Optional features can be enabled to trigger Email notifications based on the logs severity level.

Installation

Install the Package

  npm install aws-logging

Import the module

 let Logger = require('aws-logging');

Configure your logger

 Logger.config.update(
    {
        tableName : "SERVICE-LOGS",  
        mailList : ["example@icloud.com"],
        stage : "Dev",
        mailSubject : "New AWS Log",
        sourceEmail : "example@yourVerifiedEmailOrDomain.com",
        notifyOnSeverityLevel : 10,
        serviceName : "sample-service",
        enableNotifications : false,
        region : "us-east-2",
        accessKeyId : "xxxx",
        secretAccessKey : "xxxx"

    });

Parameter	Type	Description
`tableName`	`String`	Required. The name of the table that will be automatically created to store your logs. Defaults to `"SERVICE-LOGS"`. Must be unique from other table names.
`mailList`	`Array`	Optional. A list of recipient emails that will recieve log alerts
`mailSubject`	`String`	Optional. The email subject to be displayed for recipients when they recieve a log alert. Defaults to `"New AWS Log"`
`sourceEmail`	`String`	Optional. The sender email used to send the logs. Must be a verified email in your AWS account or under a verified Domain
`notifyOnSeverityLevel`	`Integer`	Required. The severity level a log must have in order to trigger an email alert. Defaults to `10`. (max 10 - min 0)
`serviceName`	`String`	Required. The name of the service you added this package to. This will be used to identify which service the log belongs to in the `SERVICE-LOGS` table
`enableNotifications`	`Boolean`	Optional. Specify if you want email alerts enabled. Note : If set to `true`, The following fields will be required : `mailList`, and `sourceEmail` .
`region`	`String`	Required . The AWS region you want this Logger configured for. Note : Must be the same as the region that the `sourceEmail` is configured for in your AWS account
`accessKeyId`	`String`	Required . Your AWS IAM access Key. Not required if you dont have to configure this before using `aws-sdk` in your service
`secretAccessKey`	`String`	Required . Your AWS IAM secret Key. Not required if you dont have to configure this before using `aws-sdk` in your service

Usage

Parameter	Type	Description
`message`	`String`	Required. The message you want to log
`severity`	`Array`	Optional. Severity level (max 10 - min 0). Defaults : `{Log : 1 , Warn : 2 , Error : 3}`
`details`	`Any`	Optional. Any additional details you may want to add. Defaults to false

Log

 Logger.log("Logging data");
 //or
 Logger.log("Logging data", 1);
 //or
 Logger.log("Logging data", 1 , {attribute1 : "1", attribute1 : "2", });

Warn

 Logger.warn("Warning data");
 //or
 Logger.warn("Warning data", 2);
 //or
 Logger.warn("Warning data", 2 , {attribute1 : "1", attribute1 : "2", });

Error

 Logger.error("Error data");
 //or
 Logger.error("Error data", 3);
 //or
 Logger.error("Error data", 3 , {attribute1 : "1", attribute1 : "2", });