logram - push logs updates to Telegram

Use

1. Install Rust via Rustup
2. Install logram: cargo install logram
3. Create bot
4. Run logram in echoID mode: logram echoID <bot token> and get needed chat ids:
   • For regular chat: send any message to bot
   • For group chat: add bot to group
   • For channel: forward any message from channel to bot (dont forget add bot to channel admins)
5. Write config from example
6. Run in normal mode logram <path to config>

Config example

```yaml telegram: # bot token token: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 # default chat (for updates from files without custom chat and errors) chat: 12345678

watcher: # watching files (logs) files: # path to file - path: /var/log/awesome.log # custom chat for this file (optional) chat: 12345678 # push updates only which matches that regex (optional) # (more info: doc.rust-lang.org/regex) regex: critical ```

Systemd service

1. Create link: sudo ln -s /home/<user>/.cargo/bin/logram /usr/bin/logram
2. Copy config to /etc/logram.yaml
3. Copy logram.service to /etc/systemd/system
4. Reload services: sudo systemctl daemon-reload
5. Enable service: sudo systemctl enable logram
6. Run service: sudo systemctl start logram

Use logram as slog drain

Logram implements slog::Drain, example usage: 1. Import logram as library toml [dependencies] slog = "2.0" logram = "0.2" 2. Use logram as drain ```rust

[macro_use]

extern crate slog; extern crate slog_logram;

use slog::Drain; use slog_logram::{TelegramDrain, Config, Formats};

fn main() { // Telegram config let config = Config { // Bot token token: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11".to_string(), // Chat id chat: 12345678, };

// Message format can be changed
// Formats support Telegram HTML markup (core.telegram.org/bots/api#html-style)
let formats = Formats {
    // Message format, variables: global_kv, record, record_kv
    // Default: "{global_kv}\n\n{record}{record_kv}"
    message: None,
    // Record format, variables: msg, level, line, column, file, tag, module, function
    // Default: "<b>{level} {file}:{line}</b>\n<pre>{msg}</pre>"
    record: None,
    // Values format, variables: key, val
    // Default: "<b>{key}:</b> {val}"
    kv: None,
};

let drain = TelegramDrain::new(config, formats).unwrap().fuse();
let root = slog::Logger::root(drain, o!("global_values" => "supported"));

info!(root, "hello, Telegram"; "log_values" => "also_supported");

} ```