Posts log events to Slack via API
Project description
Python log handler that posts to a Slack channel. Posts to the Slack API using https://slack.dev/python-slack-sdk.
Created with the intention of using for a Internal project, but some effort has been made to make it generic enough that any Python project could use it.
Installation
pip install slackclient-log-handler
Options
api_token (required)
Generate a key at https://api.slack.com/
channel (required)
Set which channel you want to post to, e.g. “#general”.
username
The username that will post to Slack. Defaults to “Python logger”.
icon_url
URL to an image to use as the icon for the logger user
icon_emoji
emoji to use as the icon. Overrides icon_url. If neither icon_url nor icon_emoji is set, :heavy_exclamation_mark: will be used.
fail_silent
Defaults to False. If your API key is invalid or for some other reason the API call returns an error, this option will silently ignore the API error. If you enable this setting, make sure you have another log handler that will also handle the same log events, or they may be lost entirely.
Django configuration
Logging reference: https://docs.djangoproject.com/en/stable/topics/logging/
This example will send INFO and ERRORS to Slack, as well as errors to admin emails.
Set SLACK_API_KEY in your settings module.
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'filters': {
'require_debug_false': {
'()': 'django.utils.log.RequireDebugFalse'
}
},
'handlers': {
'mail_admins': {
'level': 'ERROR',
'filters': ['require_debug_false'],
'class': 'django.utils.log.AdminEmailHandler'
},
'slack-error': {
'level': 'ERROR',
'api_token': SLACK_API_KEY,
'class': 'slackclient_log_handler.SlackclientLogHandler',
'channel': '#general'
},
'slack-info': {
'level': 'INFO',
'api_token': SLACK_API_KEY,
'class': 'slackclient_log_handler.SlackclientLogHandler',
'channel': '#general'
},
'loggers': {
'django.request': {
'handlers': ['mail_admins', 'slack-error', 'slack-info'],
'level': 'ERROR',
'propagate': True,
},
}
}
}
Example Python logging handler
This is how you use slackclient_log_handler as a regular Python logging handler. This example will send a error message to a slack channel.
import logging
from slackclient_log_handler import SlackclientLogHandler, NoStacktraceFormatter
# Create slack handler
slack_handler = SlackclientLogHandler('my-channel-token', 'my-channel-name')
# Create logger
logger = logging.getLogger('debug_application')
logger.addHandler(slack_handler)
# OPTIONAL: Define a log message formatter.
# If you have set stack_trace=True, any exception stack traces will be included as Slack message attachments.
# You therefore need to use NoStacktraceFormatter as a base to exclude the trace from the main message text.
formatter = NoStacktraceFormatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
slack_handler.setFormatter(formatter)
# Define the minimum level of log messages you want to send to Slack
slack_handler.setLevel(logging.DEBUG)
# Test logging
logger.error("Debug message from slack!")
Slack message formatting
This example use a subclass that will send a formatted message to a slack channel. Reference: https://api.slack.com/docs/message-formatting
class CustomLogHandler(SlackclientLogHandler):
def build_msg(self, record):
message = "> New message :\n" + record.getMessage()
return message
License
Apache 2.0
Slack-sdk is also under MIT.
See also: https://api.slack.com/terms-of-service
Project details
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
Hashes for slackclient_log_handler-0.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72b8fa1f64992e43b5bfe2d60ce1b6b232f41d54232dd5df104b605abea6ad4a |
|
MD5 | a8c52a8945d12994eed155fb2d8b4a52 |
|
BLAKE2b-256 | b8401f12bb28bdfc726cb8af283f7d51c029ff60ff8265b1b17763099db8d9eb |
Hashes for slackclient_log_handler-0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e464d40e3c7d95956cee23234e0ee2bd9b30b7fd94f45221564402fc1e5cd3a7 |
|
MD5 | 33446875ce144d503e9b3e1515273904 |
|
BLAKE2b-256 | aafbca8f3a454da63cbd2ae8d33c91aba44fef4ffd08d0c3430117c9ede7025c |