watchtower

Watchtower is a log handler for Amazon Web Services CloudWatch Logs.

CloudWatch Logs is a log management service built into AWS. It is conceptually similar to services like Splunk and Loggly, but is more lightweight, cheaper, and tightly integrated with the rest of AWS.

Watchtower, in turn, is a lightweight adapter between the Python logging system and CloudWatch Logs. It uses the boto3 AWS SDK, and lets you plug your application logging directly into CloudWatch without the need to install a system-wide log collector. It aggregates logs into batches to avoid sending an API request per each log message, while guaranteeing a delivery deadline (60 seconds by default).

Installation

pip install watchtower

Synopsis

Install awscli and set your AWS credentials (run aws configure).

import watchtower, logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
logger.addHandler(watchtower.CloudWatchLogHandler())
logger.info("Hi")
logger.info(dict(foo="bar", details={}))

After running the example, you can see the log output in your AWS console.

Example: Flask logging with Watchtower

import watchtower, flask, logging

logging.basicConfig(level=logging.INFO)
app = flask.Flask("loggable")
handler = watchtower.CloudWatchLogHandler()
app.logger.addHandler(handler)
logging.getLogger("werkzeug").addHandler(handler)

@app.route('/')
def hello_world():
    return 'Hello World!'

if __name__ == '__main__':
    app.run()

Examples: Querying CloudWatch logs

This section is not specific to Watchtower. It demonstrates the use of awscli and jq to read and search CloudWatch logs on the command line.

Metadata

Release files for watchtower 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for watchtower 0.1.6
File	Size	Uploaded
watchtower-0.1.6.tar.gz	6.1 kB	Dec 13, 2015	Details

Built distribution (wheel)

Table of built distributions (wheels) for watchtower 0.1.6
File	Interpreter	ABI	Platform	Reset
watchtower-0.1.6-py2.py3-none-any.whl 8.1 kB Dec 13, 2015	Python 3, Python 2	none	any	Details

Total release size: 14.2 kB

Release files / watchtower-0.1.6.tar.gz

Download URL	watchtower-0.1.6.tar.gz
Size	6.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`8ee1a67d761971812b02ce5b98d6fbd486e792b7726cfbf64be146baf3fcdc51`
BLAKE2b-256 checksum How to use checksums	`44d34f789305ae63cc8752094feb4d3a4fb4142c418a3e7e48ccc19e98e3bfb5`
Upload date	Dec 13, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / watchtower-0.1.6-py2.py3-none-any.whl

Download URL	watchtower-0.1.6-py2.py3-none-any.whl
Size	8.1 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`e46d722bc8aa0640eda35c563419f36ee2186919d01f3b2c8f276a23e3f1f337`
BLAKE2b-256 checksum How to use checksums	`5cc03ed815c4b62a7d9a5f692ada78078718deeee2a6a0605aeed69716c7cd19`
Upload date	Dec 13, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No