docker-log-driver-telegram

Telegram Log Driver

Docker logging driver that forwards container logs to Telegram chats via a bot.

Quick Start

# Install plugin
docker plugin install sklyarx/docker-log-driver-telegram:latest --alias telegram --grant-all-permissions

# Run container with the driver
docker run --log-driver=telegram \
  --log-opt token="<bot_token>" \
  --log-opt chat_id="<chat_id>" \
  your_image

Installation

Plugin Management

# Install
docker plugin install sklyarx/docker-log-driver-telegram:latest --alias telegram --grant-all-permissions

# Upgrade
docker plugin disable telegram --force
docker plugin upgrade telegram sklyarx/docker-log-driver-telegram:latest --grant-all-permissions
docker plugin enable telegram
systemctl restart docker

# Uninstall
docker plugin disable telegram --force
docker plugin rm telegram

Plugin Environment

docker plugin disable telegram --force
docker plugin set telegram ENV=production LOG_LEVEL=info
docker plugin enable telegram

Configuration

Container Level

Use with docker run:

docker run --log-driver=telegram \
    --log-opt token="<bot_token>" \
    --log-opt chat_id="<chat_id>" \
    --log-opt template="{container_name}: {log}" \
    your_image

Use with docker-compose.yml:

version: '3.8'
services:
  app:
    image: your/image
    logging:
      driver: telegram
      options:
        token: "<bot_token>"
        chat_id: "<chat_id>"
        template: "{container_name}: {log}"

Daemon Level (Default for All Containers)

Edit /etc/docker/daemon.json:

{
  "log-driver": "telegram",
  "log-opts": {
    "token": "<bot_token>",
    "chat_id": "<chat_id>"
  }
}

Restart Docker after changes: systemctl restart docker

Options

filter-regex sends only log messages that match the regex.

Template Tags

To customize the log message format using the template option, you can use the following tags:

Extra attributes populated by Docker from labels, labels-regex, env, and env-regex can also be used as template tags.