Installation

pip install log-to-slack

Options

Example Python logging handler

This is how you use slacker_log_handler as a regular Python logging handler. This example will send a error message to a slack channel.

import logging
import sys
from datetime import datetime
from log_to_slack import SlackLogHandler, NoStacktraceFormatter

logger = logging.getLogger("Daily Report")
logger.setLevel(logging.DEBUG)

""" Adding slack handler """
slack_handler = SlackerLogHandler(
    "xoxb-XXXXX-XXX",  # slack api token
    "C0XXXXXXXXX", # channel id not channel name
    stack_trace=True,
    fail_silent=True,
)
formatter = NoStacktraceFormatter(
    "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)
slack_handler.setFormatter(formatter)
slack_handler.setLevel(logging.ERROR)
logger.addHandler(slack_handler)

if __name__ == "__main__":
    logger.debug("Debug message to slack!")
    logger.info("Info message to slack!")
    logger.warning("Warning message to slack!")

    try:
        x = 5 / 0
    except:
        logger.exception("Exception message to slack!")
        # # you can also use the below statement to log error with trace info
        # logger.error("Error message to slack!", exc_info=True)

Slack message formatting

This example use a subclass that will send a formatted message to a slack channel. Reference: https://api.slack.com/reference/surfaces/formatting

class CustomLogHandler(SlackLogHandler):
    def build_msg(self, record):
        message = "> New message :\n" + record.getMessage()
        return message

License

Apache 2.0

Slacker is also under Apache 2.0.

See also: https://api.slack.com/terms-of-service