Logs applicatifs

Les logs applicatifs vous permettent d'envoyer la sortie Log:: de votre application à Quiet Guard et de la consulter à côté des exceptions qu'elle explique. Les journaux se trouvent dans l'onglet Journaux de chaque projet, dans le panel /app.

Fonctionnalité payante. Les logs applicatifs sont conditionnés à la fonctionnalité de plan logs. Sur le plan Free, l'ingestion des logs est refusée ; les plans Indie et Studio l'incluent. Voir Facturation et plans.

Ingestion par lots

Les logs sont envoyés par lots, pas une requête par ligne, pour limiter la surcharge. Votre client met en mémoire tampon les entrées de log et les envoie à /api/v1/logs, généralement à la fin de la requête et après les jobs de file d'attente.

Chaque lot est un tableau d'entrées de log :

{
  "logs": [
    {
      "level": "error",
      "message": "La passerelle de paiement a expiré",
      "context": { "order_id": 1234 },
      "channel": "payments",
      "environment": "production",
      "release": "9f2c1ab",
      "logged_at": "2026-06-28T10:15:00+00:00"
    }
  ]
}

Un lot doit contenir entre 1 et 500 entrées. Seul message est requis par entrée ; level, context, channel, environment, release et logged_at sont facultatifs. Le contrat complet figure dans la référence de l'API d'ingestion.

Si votre plan n'inclut pas les logs, le point d'entrée répond 403 Forbidden :

{ "message": "Application logs are not available on your current plan." }

Comment cela se décompte du quota

Les logs partagent le même quota mensuel d'événements que les exceptions, chaque entrée de log stockée compte pour un événement. C'est important pour deux raisons :

1. Quota souple. Lorsqu'un lot ferait dépasser le quota de votre plan (plus une marge de tolérance de 10 %), Quiet Guard ne stocke que ce qui rentre et abandonne silencieusement le surplus. Aucune erreur, aucune facturation surprise, la réponse indique simplement combien d'entrées ont été stockées :

``json { "message": "accepted", "stored": 137 } ``

Ainsi, un lot de 200 entrées avec seulement 137 places restantes dans votre quota en stocke 137 et en abandonne 63.

1. Rétention. Les logs stockés sont purgés selon la fenêtre de rétention de votre plan (7 / 30 / 90 jours pour Free / Indie / Studio) par le job de nettoyage quotidien.

Voir Facturation et plans pour les détails de quota, de tolérance et de rétention.

Chiffrement au repos

Si votre équipe a le stockage chiffré actif, le message et le contexte de chaque entrée de log sont scellés avec la clé publique de votre équipe à l'ingestion, et les colonnes en clair sont vidées. Les métadonnées (niveau, canal, environnement, release, horodatage) restent en clair pour que la liste et les filtres continuent de fonctionner. Les logs verrouillés affichent un espace réservé jusqu'à ce que vous déverrouilliez la session avec votre phrase secrète.

Lire la page des journaux

L'onglet Journaux d'un projet est pensé pour le balayage visuel :

• Une timeline de sévérité sur 7 jours surplombe le tableau: erreurs, avertissements et infos empilés par jour : les pics se voient avant de faire défiler.
• Les filtres sont toujours visibles au-dessus du tableau : groupe de sévérité en un clic (erreurs / avertissements / info), multi-sélection de niveaux, environnement et canal.
• Le tableau se rafraîchit automatiquement toutes les 30 secondes, et une note sous l'en-tête rappelle la durée de conservation selon votre offre.
• Sur la page d'une entrée, un contexte imbriqué s'affiche aussi en JSON brut mis en forme, en plus de la grille clé-valeur.