Skip to main content

Discord Logger is a custom message logger to Discord for Python 3

Project description

Python Discord Logger

A custom message logger to Discord for Python 3. This project was inspired from winston-discord-transport for NodeJS and built using discord-webhook, which offers an easy interface for constructing and sending messages through a Discord webhook.

If you are looking for a Slack alternative, please check python-slack-logger.

PyPI - Python Version PyPI version Downloads PyPI - Wheel License: MIT Code style: black

Install

Install via pip: pip install discord-logger

Basic Usage

from discord_logger import DiscordLogger

options = {
    "application_name": "My Server",
    "service_name": "Backend API",
    "service_icon_url": "your icon url",
    "service_environment": "Production",
    "display_hostname": True,
    "default_level": "info",
}

logger = DiscordLogger(webhook_url="your discord webhook url", **options)
logger.construct(title="Health Check", description="All services are running normally!")

response = logger.send()

Image

Configure various options

There are numerous configurations available to customise the bot.

options = {
    # Application name would replace the webhook name set during creating of the webhook
    # It would appear as the name of the bot
    # If unset, the default value would be "Application"
    "application_name": "My Server",

    # Service name would be the name of the service sending the message to your Discord channel
    # This would usually be the name of the application sending the notification
    # If unset, the default value would be "Status Bot"
    "service_name": "Backend API",

    # Service icon URL is the icon image for your application
    # This field accepts a URL to the icon image
    # If unspecified, the icon wouldn't be set
    # If misconfigured, the icon wouldn't load and a blank space would appear before the service name
    "service_icon_url": "your icon url",

    # Usually services would run in staging and production environments
    # This field is to specify the environment from which the application is reponding for easy identification
    # If unset, this block would not appear in the message
    "service_environment": "Production",

    # An option to specify whether or not to display the hostname in the messages
    # The hostname is set by default, but it could be disabled by specifically setting this to `False`
    "display_hostname": True,

    # The default importance level of the message
    # The left bar color of the message would change depending on this
    # Available options are
    # - default: 2040357
    # - error: 14362664
    # - warn: 16497928
    # - info: 2196944
    # - verbose: 6559689
    # - debug: 2196944
    # - success: 2210373
    # If the `error` field is set during the construction of the message, the `level` is automatically set to `error`
    # If nothing is specified, `default` color would be used
    "default_level": "info",
}

Emojis inbuilt! 😃

An appropriate emoji is automatically added before the title depending on the level.

Following is the map between level and the emoji added.

  • default = :loudspeaker: 📢
  • error = :x:
  • warn = :warning: ⚠️
  • info = :bell: 🔔
  • verbose = :mega: 📣
  • debug = :microscope: 🔬
  • success = :rocket: 🚀

Examples

Set Service Name, Icon and Environment for easy identification

You can configure the log message with service name, icon and environment for easy identification. The Host field which is the hostname of the server is automatically added for every message.

You can even send any meta information like the data in the variables, module names, metrics etc with the metadata field while constructing the message. These data should be passed as a dictionary.

from discord_logger import DiscordLogger

webhook_url = "your discord webhook url"
options = {
    "application_name": "My Server",
    "service_name": "Backend API",
    "service_icon_url": "your icon url",
    "service_environment": "Production",
    "default_level": "info",
}

logger = DiscordLogger(webhook_url=webhook_url, **options)
logger.construct(
    title="Health Check",
    description="Issue in establishing DB connections!",
    error="Traceback (most recent call last):\n ValueError: Database connect accepts only string as a parameter!",
    metadata={"module": "DBConnector", "host": 123.332},
)

response = logger.send()

Image

Send messages without Hostname

In case you do not want the hostname to be displayed in the message, disable it by setting "display_hostname": False in the options as follows.

from discord_logger import DiscordLogger

webhook_url = "your discord webhook url"
options = {
    "application_name": "My Server",
    "service_name": "Backend API",
    "service_icon_url": "your icon url",
    "service_environment": "Production",
    "default_level": "info",
    "display_hostname": False,
}

logger = DiscordLogger(webhook_url=webhook_url, **options)
logger.construct(title="Health Check", description="All services are running normally!")

response = logger.send()

Image

Send messages with different log-levels

The log-level indicates the importance of the message. It changes the color of the discord message in particular. Currently supported levels are,

  • error
  • warn
  • info
  • verbose
  • debug
  • success

The log-level can be set during construction of the message like through the parameter level.

If the parameter isn't provided, it'll be set to the one given in default_level. Any invalid input would be ignored and the log-level would be automatically be set to default.

Any complicated nested dictionary can be passed to the metadata field and the message gets forrmatted accordingly for easy reading.

from discord_logger import DiscordLogger

webhook_url = "your discord webhook url"
options = {
    "application_name": "My Server",
    "service_name": "Backend API",
    "service_icon_url": "your icon url",
    "service_environment": "Production",
    "default_level": "info",
}

logger = DiscordLogger(webhook_url=webhook_url, **options)
logger.construct(
    title="Celery Task Manager",
    description="Successfully completed training job for model v1.3.3!",
    level="success",
    metadata={
        "Metrics": {
            "Accuracy": 78.9,
            "Inference time": "0.8 sec",
            "Model size": "32 MB",
        },
        "Deployment status": "progress",
    },
)

response = logger.send()

Image

Send complete error traceback

The error field can contain any error message. It will be automatically be formatted in the final message. For example, you can send a complete traceback of an error message to debug faster!

import traceback

from discord_logger import DiscordLogger


def get_traceback(e):
    tb = (
        "Traceback (most recent call last):\n"
        + "".join(traceback.format_list(traceback.extract_tb(e.__traceback__)))
        + type(e).__name__
        + ": "
        + str(e)
    )
    return tb


webhook_url = "your discord webhook url"
options = {
    "application_name": "My Server",
    "service_name": "Backend API",
    "service_icon_url": "your icon url",
    "service_environment": "Production",
    "default_level": "info",
}

err = KeyError("`email` field cannot be None")

logger = DiscordLogger(webhook_url=webhook_url, **options)
logger.construct(
    title="Runtime Exception",
    description=err.__str__(),
    error=get_traceback(err),
    metadata={"email": None, "module": "auth", "method": "POST"},
)

response = logger.send()

Image

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord-logger-1.2.5.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

discord_logger-1.2.5-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file discord-logger-1.2.5.tar.gz.

File metadata

  • Download URL: discord-logger-1.2.5.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.10.0 readme-renderer/34.0 requests/2.23.0 requests-toolbelt/1.0.0 urllib3/1.26.20 tqdm/4.64.1 importlib-metadata/4.2.0 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.10

File hashes

Hashes for discord-logger-1.2.5.tar.gz
Algorithm Hash digest
SHA256 95d5fae3e9de53a827f79bc46fbce3f53567872c7951a5e4b453cdeba7bca2aa
MD5 1a24c5ce14214664f1142fefa3433420
BLAKE2b-256 27cce0b375c3d71a7a6524b126ed8c06f2f9a8a85cdf09ea6f5868cda4d36af9

See more details on using hashes here.

File details

Details for the file discord_logger-1.2.5-py3-none-any.whl.

File metadata

  • Download URL: discord_logger-1.2.5-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.10.0 readme-renderer/34.0 requests/2.23.0 requests-toolbelt/1.0.0 urllib3/1.26.20 tqdm/4.64.1 importlib-metadata/4.2.0 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.10

File hashes

Hashes for discord_logger-1.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b7625ee87e99971e7763b31615e500175edb0dc52682a3925bd4ed2663dbbb08
MD5 f10289231569ac216b764aa115bc061b
BLAKE2b-256 b12e735aa6b9f3c36287c1d80be1965c3bb28e5a460bb49738b8dcbf22ff6b85

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page