#telegram #logs #docker #anywhere #journald #send #container

bin+lib logram

Utility that takes logs from anywhere and sends them to Telegram

10 releases (6 stable)

2.0.0 Jan 23, 2021
1.2.0 Apr 1, 2019
1.1.2 Feb 16, 2019
1.1.1 Jan 3, 2019
0.1.1 Nov 5, 2017

#8 in #journald

41 downloads per month

MIT and maybe LGPL-2.1-or-later WITH GCC-exception-2.0

45KB
1K SLoC

logram crates.io

Utility that takes logs from anywhere and sends them to Telegram. Supports log collection from files, journald and docker containers. More about available log sources see at docs/log_sources.md.

Usage

  1. Create a Telegram bot via @BotFather
  2. Download the latest logram release
  3. Install it:
    • .deb based Linux: sudo dpkg -i logram-...amd64.deb
    • .rpm based Linux: sudo rpm -i logram-...x86_64.rpm
  4. Find out the chat id with your bot (see docs/chat_id.md)
  5. Change the config (/etc/logram.yaml in Linux) (see docs/config.md)
  6. Run logram: sudo systemctl start logram
  7. ... and add it to the autostart: sudo systemctl enable logram

Also logram can work with log, see docs/lib.md for detals.

Building

If you need to build a logram manually, do this:

  1. Clone repo: git clone git@github.com:mxseev/logram.git
  2. Choose the features you want:
    • bin_core - required for all log sources
    • ls_counter - Counter log source
    • ls_filesystem - Filesystem log source
    • ls_journald - Journald log source
    • ls_docker - Docker log source
  3. Build the project with these features: cargo build --release --features=bin_core,ls_filesystem

Making .deb package

  1. Install cargo-deb
  2. Edit package.metadata.deb.features in Cargo.toml
  3. Build package: cargo deb
  4. Use target/debian/logram_..._amd64.deb

Making .rpm package

  1. Install cargo-generate-rpm
  2. Build project: cargo build --release --features=bin_core,...
  3. Strip debug symbols: strip -s target/release/logram
  4. Build package: cargo generate-rpm
  5. Use target/generate-rpm/logram-...x86_64.rpm

Dependencies

~3–17MB
~273K SLoC