Python CloudWatch Logging
Project description
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()(See also http://flask.pocoo.org/docs/errorhandling/.)
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file watchtower-0.1.6.tar.gz.
File metadata
- Download URL: watchtower-0.1.6.tar.gz
- Upload date:
- Size: 6.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8ee1a67d761971812b02ce5b98d6fbd486e792b7726cfbf64be146baf3fcdc51 |
|
| MD5 | e6ff8dfc149e94aada9d464be23eadee |
|
| BLAKE2b-256 | 44d34f789305ae63cc8752094feb4d3a4fb4142c418a3e7e48ccc19e98e3bfb5 |
File details
Details for the file watchtower-0.1.6-py2.py3-none-any.whl.
File metadata
- Download URL: watchtower-0.1.6-py2.py3-none-any.whl
- Upload date:
- Size: 8.1 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e46d722bc8aa0640eda35c563419f36ee2186919d01f3b2c8f276a23e3f1f337 |
|
| MD5 | e5e7c98c6ac0ae1ba762c4a11683381f |
|
| BLAKE2b-256 | 5cc03ed815c4b62a7d9a5f692ada78078718deeee2a6a0605aeed69716c7cd19 |
