slack_python_logging

A Python module that makes logging to Slack easy

The getLogger method implemented here lets you create logging.Logger objects containing a stream handler and custom slack handler. The stream handler mimics the behavior and formatting of logging.BasicConfig, and the slack handler sends the logged message as well as some useful info (incl. a traceback) to Slack. You can set the log levels of these handlers separately, the idea being that you can limit slack messages to serious errors while keeping a more complete log locally.

Installation

The version on PyPI is out of date. Instead use pip:

pip install git+https://github.com/neoliberal/slack_python_logging

Or you can clone the repo, in which case I assume you know what you're doing

Usage

You must have the SLACK_WEBHOOK_URL environment variable set before initializing

import slack_python_logging

logger = slack_python_logging.getLogger(
    app_name = "My App", # Appears in slack messages
    stream_loglevel = "DEBUG" # What gets printed to stdout
    slack_loglevel = "CRITICAL" # What gets sent to Slack
)

logger.debug("foo") # Printed to stderr only
logger.critical("bar") # Printed to stderr and Slack