serverless-plugin-infrequent-access-logs
v0.2.7
Published
Serverless plugin to enable infrequent access CloudWatch log groups.
Downloads
172
Maintainers
Readme
serverless-plugin-infrequent-access-logs
This plugin allows you to create and configure infrequent access log groups for your lambdas. Infrequent access CloudWatch logs are 50% cheaper in data ingestion cost and are suitable for workloads that do not require the more advanced features of CloudWatch.
As CloudFormation does not support changing log group classes, this plugin will instead add new infrequent access log groups to your CloudFormation stack following the pattern:
/aws/lambda/plugin/ia/${lambda-name}
Usage
- Install the plugin.
npm install serverless-plugin-infrequent-access-logs
- Register it in your
serverless.yml
file.
service: sample
plugins:
- serverless-plugin-infrequent-access-logs
provider:
name: aws
custom:
infrequentAccessLogs: true # Set globally for all lambdas
infrequentAccessLogRetention: 30
functions:
function1:
function2:
infrequentAccessLogs: true # Set for specific lambdas (will override the global value)
infrequentAccessLogRetention: 7
Notes
- Adding this plugin into your
serverless.yml
file will automatically result in IA log groups being created for all your lambdas, even if you do not setinfrequentAccessLogs: true
. - Setting
infrequentAccessLogs: true
to a lambda simply configures the lambda to use the IA log group. - When setting
infrequentAccessLogs: false
, the IA log groups created by this plugin will remain but will not be used by your lambdas. - Any existing log groups managed by Serverless will remain in your CloudFormation stack.
- When removing this plugin, any IA log groups created by this plugin will also be deleted from your CloudFormation stack.
- Valid log retention values can be found here.
infrequentAccessLogRetention
works independently frominfrequentAccessLogs
in the sense that you can specify/update either one without the other.- If no values are set, the default configuration is false and the default log retention is forever.