readme.md

statsd middleware for Telegraf

statsd middleware for Telegraf (Telegram bot framework).

Installation

$ npm install telegraf-statsd

Example

const Telegraf = require('telegraf')
const stats = require('telegraf-statsd')

const telegraf = new Telegraf(process.env.BOT_TOKEN)

telegraf.use(stats())

telegraf.on('text', (ctx) => {
  return ctx.reply('Big brother watch you!')
})

telegraf.startPolling()

API

Options

• host - optional statsd host
• port - optional statsd port
• prefix - optional statsd prefix ('.' is appended)
• tcp - use TCP instead of UDP

User context

Telegraf user context props and functions:

app.use((ctx) => {
  ctx.statsd  // Statsy instance
})

Statsy help

Metrics

Metric name	Type	Description
counter	counter	bot updates counter
<type>.count	counter	update type counter (message, inlineQuery, etc.)
message.<subtype>.count	counter	message subtype counter(text, sticker, etc.)
errors.count	counter	error counter
errors.<type>.count	counter	update type error counter
errors.message.<subtype>.count	counter	message subtype error counter
duration	timer	handler duration
<type>.duration	timer	update type handler duration
message.<subtype>.duration	timer	message subtype handler duration
chats	set	chats set
users	set	users set
text.size	histogram	text messages length