This package provides handlers to send logging messages to telegram chats.
Project description
pyTelegramLogger
Description
This package provides handlers to send logging messages to telegram chats. It uses a separate thread for handling messages (see logging.QueueHandler for details). You can send messages to multiple chats, including big messages (over 4096 chars). Big messages will be split into several parts and tagged by unique hashtag for current log record.
Installation
$ pip install pyTelegramLogger
$ pipenv install pyTelegramLogger
Usage
- Configure logger
LOGGING_CONFIG = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'telegram': {
'class': 'telegram_logger.TelegramHandler',
'chat_ids': [123456, 123456789],
'token': 'bot_token,
},
},
'loggers': {
'telegram': {
'handlers': ['telegram'],
}
}
}
- Usage
# Run once at startup:
logging.config.dictConfig(LOGGING_CONFIG)
# Include to send logging messages to telegram
logger = logging.getLogger('telegram')
logger.warning('Warning message!')
FAQ
1. Can I use my own formatter class for messages?
Yes you can. You can inherit from base class telegram_logger.TelegramFormatter
and define how to send big messages (over 4096 chars) in method format_by_fragments(self, record: logging.LogRecord, start: int=0) -> List[str]
.
Also you can use your own formatter class.
Then configure using standart configuration dictionary schema:
LOGGING_CONFIG = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'myFormattrer': {
'class': 'MyFormatterClass',
'fmt': '%(levelname)_%(name) : %(funcName)'
}
}
'handlers': {
'telegram': {
'class': 'telegram_logger.TelegramHandler',
'chat_ids': [123456, 123456789],
'token': 'bot_token,
'formatter': 'myFormattrer',
},
},
'loggers': {
'telegram': {
'handlers': ['telegram'],
}
}
}
2. What if I don't want to send messages to telegram during development?
Sometimes, when you just develope you app and you dont want to send log messages to telegram, but want to control it use telegram_logger.TelegramStreamHandler(cht_ids, token, stream=None)
which streams dict with message text and params instead of send it to telegram.
3. Can I use a proxy for sending messages?
Yes you can. You can specify proxy in key of config proxies
using dict format as requests:
proxies = {
'http': 'http://10.10.1.10:3128',
'https': 'http://10.10.1.10:1080',
}
LOGGING_CONFIG = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'telegram': {
'class': 'telegram_logger.TelegramHandler',
'chat_ids': [123456, 123456789],
'token': 'bot_token,
'proxies': proxies,
},
},
'loggers': {
'telegram': {
'handlers': ['telegram'],
}
}
}
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
Built Distribution
Hashes for pyTelegramLogger-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f7dab93947ae89a02432aebb29c669117893cc3b09df13870e66b4c213a31ade |
|
MD5 | 0708db4d648ba6b7502790b7fc4aa666 |
|
BLAKE2b-256 | 9ed1abb63bf9b7a0251df2b9dea956d9bc3957eef8c6d2a9c1326a9a0ff6463b |