Forwards any process StdOut and StdErr to AWS Cloudwatch. Automatically configures the log group and log stream. Uploads the log events in batches. Retries in the case of errors.
Get a pair of AWS credentials that can forward logs to CloudWatch
Make sure the following environment variables are set
AWS_REGION='us-east-1' AWS_ACCESS_KEY_ID='XXXXXXXXXXXXXXX' AWS_SECRET_ACCESS_KEY='XXXXXXXXXXXXXXX'
npm i -g aws-cloudwatch-forwarder
aws-cloudwatch-forwarder 'echo "sample application"'
echo "sample application" is your application. DO NOT forget to wrap your application in quotes.
Usage inside of a node application
The forwarder can be configured through the following environment variables.
FC_AWS_LOG_GROUP_NAMEthe AWS log group name. Defaults to
FC_AWS_LOG_STREAM_NAMEthe AWS log stream name. Defaults to the following calculated value
FC_AWS_DEBUGwhether to display AWS transmission DEBUG info. Defaults to
FC_AWS_ENABLEDwhether the AWS forwarder is enabled. Defaults to
FC_STDOUT_ENABLEDwhether to print out the piped data into the StdOut. Defaults to
FCG_POLLING_INTERVALthe wait time in milliseconds the forwarder waits before checking if there any data to forward. Defaults to
FCG_MAX_COUNT_PER_TRANSMISSIONthe maximum number of log messages to forward in a single AWS transmission. Defaults to
FCG_RETRY_COUNTthe number of retries in case of a failure. Defaults to
0. This means retry is disabled.
FCG_RETRY_DELAY_BASE_INTERVALthe base number of milliseconds to use in the exponential backoff for operation retries. Defaults to
FCG_DEBUGwhether to display forwarder events. Defaults to