📊 Logchef

Interface web mono-binaire Go pour explorer et visualiser des logs massifs stockés dans ClickHouse, façon Grafana pour les logs.

📊 Métadonnées

Champ	Valeur
Nom	Logchef
Slug	`logchef`
Catégorie principale	cat-analytics
Langage	Go (28)
Stars	⭐ 757
Dernière MAJ	2026-05-25
Repo	github.com/mr-karan/logchef
Site	logchef.app

📝 Description

Logchef est une interface d'analyse de logs légère, single-binary, écrite en Go et conçue pour s'interfacer nativement avec ClickHouse comme moteur de stockage. Le projet se positionne comme une alternative moderne à Grafana Loki / Kibana pour interroger des téraoctets de logs structurés, avec un focus sur les requêtes SQL rapides et la visualisation.

L'outil fournit un explorateur web, un système de dashboards collaboratifs, une gestion fine des sources de données ClickHouse et un système d'authentification par équipes. Idéal pour les homelabs qui ingèrent déjà des logs dans ClickHouse (via Vector, Fluent Bit, etc.) et qui veulent une UI dédiée sans la lourdeur d'un Elastic stack.

🐳 Installation Docker

services:
  logchef:
    image: ghcr.io/mr-karan/logchef:latest
    container_name: logchef
    restart: unless-stopped
    ports:
      - "7410:7410"
    volumes:
      - ./data:/data
    environment:
      - PUID=1000
      - PGID=1000
      - CLICKHOUSE_URL=tcp://clickhouse:9000
      - ADMIN_EMAIL=admin@example.com
      - ADMIN_PASSWORD=changeme

⚠️ Adapte image/port/volumes selon le README officiel : https://github.com/mr-karan/logchef

🔀 Reverse Proxy (Traefik)

services:
  logchef:
    image: ghcr.io/mr-karan/logchef:latest
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.logchef.rule=Host(`logs.example.com`)"
      - "traefik.http.routers.logchef.entrypoints=websecure"
      - "traefik.http.routers.logchef.tls.certresolver=letsencrypt"
      - "traefik.http.services.logchef.loadbalancer.server.port=7410"

🔧 Configuration

Définir CLICKHOUSE_URL (ou les variables CLICKHOUSE_HOST/CLICKHOUSE_PORT/CLICKHOUSE_USER/CLICKHOUSE_PASSWORD) pour pointer vers la base
Créer un compte administrateur initial via ADMIN_EMAIL / ADMIN_PASSWORD (sera créé au premier démarrage)
Brancher l'ingestion via Vector/Fluent Bit directement dans ClickHouse, Logchef ne fait que la lecture

🔀 Alternatives

Open source :

Grafana + Loki (stack classique, log agregation + dashboards)
Kibana (couche UI de l'Elastic stack)
HyperDX (alternative open source à Datadog, ClickHouse-native)
OpenObserve (ZincObserve) — observabilité unifiée, ClickHouse-based

Propriétaires :

Datadog Logs (SaaS leader, facturation à l'ingestion)
Better Stack (ex-Closed source Logs), Splunk, New Relic

🔒 Sécurité

Authentification obligatoire côté UI, comptes stockés en base ClickHouse
ClickHouse doit être placé sur un réseau privé (les requêtes SQL traversent Logchef, attention aux injections de paramètres)
Exposer Logchef uniquement derrière HTTPS avec un middleware d'auth (OIDC, Authentik)

📚 Ressources

🔗 Pages Liées

cat-analytics — Catégorie analytics
Catalogue-Self-Hosted — Hub principal

3.8 KiB Raw Blame History