Metadata-Version: 2.1
Name: aws-cloudwatch-log-minder
Version: 0.1.3
Summary: Maintain AWS CloudWatch log streams
Home-page: https://github.com/binxio/aws-cloudwatch-log-minder
Author: Mark van Holsteijn
Author-email: mark@binx.io
License: BSD
Description: # AWS Cloudwatch Log minder
        AWS CloudWatch logs is an useful logging system, but it has two quircks. It does not allow you too set a default
        retention period for newly created log groups, and it does not delete empty log streams that are older than
        the retention period. This utility:
        
        1. sets a default retention period on log groups without a period set.
        1. removes empty log streams older than the retention period of the log group
        
        You can use it as a command line utility. You can also install it as an AWS Lambda function and have your
        logs kept in order, NoOps style!
        
        ## install the log minder
        to install the log minder, type:
        
        ```sh
        pip install aws-cloudwatch-log-minder
        ```
        
        ## set default retention period
        to set the default retention period on log groups without one, type:
        ```sh
        cwlogs-minder --dry-run set-log-retention --days 30
        ```
        This will show you which log groups will have its retention period set. Remove the `--dry-run` and
        it the retention period will be set.
        
        ## delete empty log streams
        To delete empty log streams older than the retention period, type:
        ```sh
        cwlogs-minder --dry-run delete-empty-log-streams
        ```
        This will show you which empty log streams will be deleted. Remove the `--dry-run` and
        these stream will be deleted.
        
        ## deploy the log minder
        To deploy the log minder as an AWS Lambda, type:
        
        ```sh
        git clone https://github.com/binxio/aws-cloudwatch-log-minder.git
        cd aws-cloudwatch-log-minder
        aws cloudformation create-stack \
                --capabilities CAPABILITY_IAM \
                --stack-name aws-cloudwatch-log-minder \
                --template-body file://./cloudformation/aws-cloudwatch-log-minder.yaml
        
        aws cloudformation wait stack-create-complete  --stack-name aws-cloudwatch-log-minder
        ```
        This will install the log minder in your AWS account and run every hour.
        
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
