title: Telebugs created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, development, error-reporting, telegram, bot, observability] confidence: medium contested: false sources: [https://selfh.st/apps/?tag=Development, https://github.com/treezio/telebugs]

💻 Telebugs

Bot Telegram minimaliste pour centraliser les rapports de bugs et d'erreurs applicatives — un endpoint HTTP simple reçoit les exceptions, le bot les transmet dans un chat ou canal Telegram pour un triage rapide par l'équipe.

📋 Informations Générales

Attribut	Valeur
Nom	Telebugs
Slug	telebugs
Description	Bot Telegram de bug reports / error reporting
Site officiel	https://telebugs.app (à vérifier)
Repository	https://github.com/treezio/telebugs (à vérifier)
Stars	0 ⭐ sur selfh.st
Licence	MIT (à vérifier)
Langage	Go / Python (à vérifier)
Catégorie	Development
Note	⚠️ Projet de niche (~0 ⭐) — utile pour les petites équipes qui veulent centraliser leurs alertes dans Telegram sans déployer une stack Sentry/GlitchTip complète.

📝 Description

Telebugs est un bot Telegram open source dont le rôle est de collecter et dispatcher les rapports d'erreurs applicatives vers un chat ou canal Telegram. Le concept est radicalement simple : une application cliente envoie une requête HTTP POST à Telebugs quand elle rencontre une exception, et Telebugs formate le payload en un message Telegram lisible dans un salon dédié.

Cas d'usage typiques : remplacer ou compléter un Sentry / GlitchTip trop lourd pour un side-project, recevoir les erreurs d'un cron ou d'un script de production directement sur le téléphone du développeur, ou faire du bug-bounty privé où des testers externes soumettent des bugs via un canal Telegram public.

Fonctionnalités attendues (à confirmer dans la doc) : endpoint HTTP simple avec token d'authentification, formatage automatique des stack traces, threading/grouping d'erreurs identiques, support de pièces jointes (screenshots, logs), filtrage par sévérité.

Positionnement vs Sentry : Sentry / GlitchTip / Bugsnag sont des plateformes d'error tracking complètes (grouping, alerting, releases, source maps, performance). Telebugs joue le rôle inverse : très léger, sans UI web dédiée (tout se passe dans Telegram), sans base complexe. Adapté aux petites structures qui n'ont pas la volumétrie pour Sentry.

⚠️ Confiance faible : 0 étoile sur selfh.st, projet récent et de niche. Politique de sécurité à vérifier (transmission en clair ? chiffrement ? stockage persistant ?). Adapter la politique PII : par défaut, les stack traces peuvent contenir emails, IPs, tokens — à sanitizer côté application cliente avant envoi.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
version: "3.8"
services:
  telebugs:
    image: telebugs/telebugs:latest
    container_name: telebugs
    restart: unless-stopped
    environment:
      - TELEGRAM_BOT_TOKEN=123456:ABC-DEF...YZ
      - TELEGRAM_CHAT_ID=-100123456789
      - API_TOKEN=secret...ts
      - LOG_LEVEL=info
    ports:
      - "8080:8080"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.telebugs.rule=Host(`telebugs.example.com`)"
      - "traefik.http.routers.telebugs.entrypoints=websecure"
      - "traefik.http.routers.telebugs.tls.certresolver=letsencrypt"
    networks:
      - proxy

networks:
  proxy:
    external: true

Création du bot Telegram

# 1. Parler à @BotFather sur Telegram, créer un bot, récupérer le token
# 2. Ajouter le bot au canal/groupe cible, le promouvoir admin
# 3. Récupérer le chat_id (via @userinfobot ou l'API getUpdates)
# 4. Lancer le container avec les variables ci-dessus

Envoi d'un rapport depuis une application

curl -X POST https://telebugs.example.com/report \
  -H "Authorization: Bearer secret...ts" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "NullPointerException in /api/users",
    "severity": "high",
    "stack": "...",
    "context": {"user_id": 42, "endpoint": "/api/users"}
  }'

⚙️ Configuration

TELEGRAM_BOT_TOKEN : fourni par @BotFather — à garder secret, permet le contrôle total du bot.
TELEGRAM_CHAT_ID : ID numérique du canal/groupe cible (négatif pour groupes, -100… pour supergroupes/canaux).
API_TOKEN : token d'authentification côté serveur HTTP — distinct du token Telegram, sert à authentifier les apps clientes.
Sévérité : à standardiser côté émetteur (info, warning, error, critical) pour permettre le filtrage Telegram.
Sanitization PII : Telebugs étant un pass-through (pas de PII store persistant par défaut), c'est côté application cliente qu'il faut filtrer emails, IPs, tokens avant envoi.

🔗 Alternatives

Sentry — La référence de l'error tracking, très complet mais lourd (Docker Compose ou SaaS).
GlitchTip — Clone open source de Sentry, plus léger, auto-hébergeable, compatible SDK Sentry.
app-bugsink — Fork minimaliste de GlitchTip, focalisé sur la simplicité pour homelab.
app-gotify — Serveur de notifications auto-hébergé (push web + mobile), canal d'alertes générique.
ntfy.sh — Pub/sub HTTP simple, consommé par n'importe quel client.

🔒 Sécurité

Tokens en variables d'environnement : TELEGRAM_BOT_TOKEN et API_TOKEN ne doivent jamais être commit dans le repo — .env gitignored ou secret manager.
HTTPS obligatoire : Telebugs reçoit potentiellement des données sensibles (stack traces, contexte applicatif) — forcer HTTPS via Traefik/Caddy.
Rate limiting : activer un rate limit sur l'endpoint /report (Traefik crowdsec-bouncer ou reverse-proxy dédié) pour éviter qu'un bug en boucle sature le canal Telegram.
PII / RGPD : les stack traces contiennent souvent des données personnelles (emails, IPs, chemins utilisateur) — sanitizer côté émetteur et définir une politique de rétention sur le canal Telegram (auto-suppression après N jours).

📚 Ressources

🔗 Pages Liées

cat-development — Catégorie Development
app-bugsink — Alternative error-tracking plus complète
app-gotify — Serveur de notifications push
app-traefik — Reverse-proxy HTTPS recommandé
securisation-home-lab — Bonnes pratiques de sécurité
recettes-docker-compose — Templates Docker

6.9 KiB Raw Blame History