SigNoz sur VPS : APM open source en 15 minutes

Les outils SaaS d'observabilité ont un modèle tarifaire redoutable : gratuit jusqu'à une poignée d'hôtes, puis la facture s'envole avec chaque service ajouté. Pour une agence web qui gère dix projets clients ou un développeur indépendant qui scale son SaaS, la note mensuelle dépasse rapidement 200 à 500 € sans que la valeur ajoutée soit proportionnelle.

SigNoz change la donne. C'est une plateforme d'observabilité open source (licence Apache 2.0) qui repose sur ClickHouse pour le stockage haute performance des traces et des métriques, et sur le protocole OpenTelemetry pour l'instrumentation. Vous gardez vos données chez vous, vous contrôlez la rétention, et vous ne payez que le VPS qui fait tourner la stack.

SigNoz s'appuie sur ClickHouse, un moteur de base de données colonnaire très gourmand en mémoire. Le minimum absolu recommandé est 4 Go de RAM — en dessous, ClickHouse se fait tuer par l'OOM killer du kernel avant même que l'UI se charge. Pour un usage production avec plusieurs applications instrumentées, visez 8 Go.

Voici la liste complète des prérequis :
- Un VPS sous Ubuntu 22.04 ou Debian 12.
- Docker Engine ≥ 24 et Docker Compose V2 installés.
- Le port 8080 ouvert dans votre pare-feu (UI SigNoz).
- Les ports 4317 (OTLP/gRPC) et 4318 (OTLP/HTTP) ouverts pour recevoir les traces.
- Un accès root ou sudo sur le VPS.
- Au moins 20 Go d'espace disque libre pour ClickHouse et ses fichiers de données.

SigNoz reçoit les traces via le protocole OTLP. Voici comment brancher une application Node.js et une application Python.

Node.js (Express) :

npm install @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node

Créez un fichier tracing.js au démarrage de votre app :

const { NodeSDK } = require('@opentelemetry/sdk-node');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');
const sdk = new NodeSDK({ instrumentations: [getNodeAutoInstrumentations()] });
sdk.start();

Lancez votre app avec la variable d'environnement pointant vers votre VPS :

OTEL_EXPORTER_OTLP_ENDPOINT="http://<IP_VPS>:4318" \
OTEL_SERVICE_NAME="mon-api" \
node -r ./tracing.js app.js

Python (FastAPI/Flask) :

pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install

OTEL_EXPORTER_OTLP_ENDPOINT="http://<IP_VPS>:4318" \
OTEL_SERVICE_NAME="mon-service-python" \
opentelemetry-instrument uvicorn main:app

Dans les deux cas, les traces apparaissent dans l'interface SigNoz sous Services dans les secondes qui suivent le premier appel HTTP.

Une fois vos applications instrumentées, SigNoz peuple automatiquement la vue Services avec la latence P50/P99, le taux d'erreur et le débit de chaque service.

Créer un dashboard personnalisé :
1. Allez dans Dashboards → New Dashboard.
2. Ajoutez un panel de type Time Series et sélectionnez une métrique Prometheus.
3. Appliquez des filtres par service, environnement ou endpoint.

Configurer une alerte sur la latence P99 :
1. Allez dans Alerts → New Alert Rule.
2. Choisissez le type Metric Based Alert.
3. Saisissez la condition : p99(signoz_latency_bucket{service_name="mon-api"}) > 500 (alerte si P99 > 500 ms).
4. Configurez le canal de notification : Slack, email ou webhook.

L'UI ne se charge pas sur le port 8080
Vérifiez que le conteneur signoz-frontend est en état running et que votre pare-feu autorise le port :

docker compose ps | grep frontend
ufw status | grep 8080

Les traces n'apparaissent pas dans l'interface
Vérifiez que le port 4318 (OTLP/HTTP) est accessible depuis votre application :

curl -v http://<IP_VPS>:4318

Une réponse 405 Method Not Allowed confirme que le collector écoute bien.

Le conteneur ClickHouse redémarre en boucle
C'est très probablement un OOM kill. Consultez dmesg | grep -i oom pour confirmer.

Erreur connection refused depuis l'app vers le VPS
Assurez-vous que les ports 4317 ou 4318 sont ouverts dans le firewall du VPS SigNoz, et que l'URL dans OTEL_EXPORTER_OTLP_ENDPOINT pointe bien vers l'IP publique du VPS, pas vers localhost.