Skip to content

kkuzmin/cwe-collector

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cwe-collector

Build Status

Alert Logic Amazon Web Services (AWS) CloudWatch Events (CWE) Collector.

Overview

This repository contains the AWS CWE JavaScript Lambda function and CloudFormation Template (CFT) for deploying a CW events collector in AWS which will collect and forward CW events to the Alert Logic CloudInsight backend services.

Installation

Refer to CF template readme for installation instructions.

How It Works

Updater Function

The Updater is a timer triggered function that runs a deployment sync operation every 12 hours in order to keep the collector lambda function up to date. The Updater syncs from the Alert Logic S3 bucket where you originally deployed from.

Collector Function

The Collector function is an AWS lambda function which takes CloudWatch events from Kinesis and sends them to the AlertLogic Ingest service data API for further processing.

  1. A CloudWatch rule is used to send CloudWatch events to a AWS Kinesis stream.
  2. An AWS Event Source Mapping is used to invoke an Alert Logic Collector lambda function to read CloudWatch events from the Kinesis stream.
  3. The Alert Logic Collector lambda function reads CloudWatch events from the Kinesis stream and forwards them to the Alert Logic Ingest service data API.

Checkin Trigger

The Checkin Scheduled Event trigger is used to report the health and status of the Alert Logic AWS lambda collector to the Azcollect back-end service based on an AWS Scheduled Event that occurs every 15 minutes.

Local Development

  1. Clone repo git clone [email protected]:alertlogic/cwe-collector.git
  2. cd cwe-collector
  3. Run make compile test package in order to perform code analysis, unit tests and package the lambda function into a zip file.
  4. Run make cfn to check CloudFromation templates.

Please use the following code style as much as possible.

Known Issues/ Open Questions

  • TBD.

Useful Links

About

AWS CloudWatch Events Collector

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 99.2%
  • Makefile 0.8%