tghook

Telegram Logrus Hook

Instead of the original, this package is able to configure the standard logging level.

This hook emits log messages (and corresponding fields) to the Telegram API for logrus.

Installation

Install the package with:

go get github.com/vad1malekseev/tghook

Usage

See the tests for working examples. Also:

package main

import (
	"time"
	
	
	"github.com/Sirupsen/logrus"
	"github.com/vad1malekseev/tghook"
)

func main() {
	hook, err := tghook.NewTelegramHook(
		"AppName", // needed to format telegram-messages 
		"secret",
		"@username",
		tghook.WithAsync(true),
		tghook.WithTimeout(30 * time.Second),
		tghook.WithMinLevel(logrus.InfoLevel), // default level is ErrorLevel
	)
	if err != nil {
		logrus.Fatalf("Encountered error when creating Telegram hook: %s", err)
	}
	logrus.AddHook(hook)
	
	logrus.Info("App started")
}

All existing levels in descending order:

• PanicLevel = 0
• FatalLevel = 1
• ErrorLevel = 2
• WarnLevel = 3
• InfoLevel = 4
• DebugLevel = 5
• TraceLevel = 6

If the minimum level equal to InfoLevel, you will receive notifications of the following levels:

• PanicLevel
• FatalLevel
• ErrorLevel
• WarnLevel
• InfoLevel

Also you can set custom http.Client to use SOCKS5 proxy for example

package main

import (
	"time"
	"net/http"
	
	"golang.org/x/net/proxy"
	"github.com/Sirupsen/logrus"
	"github.com/vad1malekseev/tghook"
)

func main() {
	httpTransport := &http.Transport{}
    httpClient := &http.Client{Transport: httpTransport}
    dialer, err := proxy.SOCKS5("tcp", "127.0.0.1:54321", nil, proxy.Direct)
    httpTransport.Dial = dialer.Dial
    
	hook, err := tghook.NewTelegramHookWithClient(
		"AppName",
		"secret",
		"@username",
		httpClient,
		tghook.WithAsync(true),
		tghook.WithTimeout(30 * time.Second),
	)
	if err != nil {
		logrus.Fatalf("Encountered error when creating Telegram hook: %s", err)
	}
    logrus.AddHook(hook)
	
	// Receive messages on failures
    logrus.Errorf("Uh oh...")
}

License

MIT