Aller au contenu principal

Logs

Streaming de logs en temps réel et recherche puissante pour le debugging.

Vue d'Ensemble​

SailOps capture et stocke les logs de toutes vos ressources :

  • Logs de conteneurs - Sortie stdout et stderr
  • Logs de base de données - Logs serveur PostgreSQL
  • Logs de gateway - Logs d'accès et d'erreur
  • Logs système - Événements de la plateforme

Voir les Logs​

Logs de Conteneur​

  1. Naviguez vers votre conteneur
  2. Cliquez sur l'onglet Logs
  3. Voir le flux de logs en temps réel

Fonctionnalités​

  • Streaming live - Les logs apparaissent en temps réel
  • Pause/Reprendre - Arrêter le flux pour examiner les logs
  • Recherche - Trouver des entrées spécifiques
  • Filtre - Par niveau, temps ou contenu
  • Download .txt - Exporter les logs correspondants sous forme de fichier texte

Format des Logs​

Entrée de Log Standard​

2024-01-15T10:30:45.123Z INFO  [app] Utilisateur connecté avec succès
2024-01-15T10:30:45.456Z ERROR [db] Timeout de connexion après 5000ms
2024-01-15T10:30:46.789Z DEBUG [api] Traitement de la requête : POST /users

Logs Structurés (JSON)​

{
"timestamp": "2024-01-15T10:30:45.123Z",
"level": "INFO",
"message": "Utilisateur connecté avec succès",
"user_id": "usr_123abc",
"request_id": "req_456def",
"duration_ms": 45
}

SailOps parse les logs JSON et rend les champs recherchables.

Niveaux de Log​

NiveauDescriptionCouleur
ERRORErreurs nécessitant attentionRouge
WARNProblèmes potentielsJaune
INFOOpérations normalesBleu
DEBUGDétails de debuggingGris

Filtrer par Niveau​

  1. Cliquez sur le filtre Niveau
  2. Sélectionnez les niveaux à afficher :
    • ERROR uniquement
    • ERROR + WARN
    • Tous les niveaux

Rechercher dans les Logs​

Recherche Simple​

Tapez dans la zone de recherche :

user login

Trouve les logs contenant "user" ET "login".

Recherche de Phrase​

Utilisez les guillemets pour les phrases exactes :

"connection refused"

Recherche par Champ​

Recherchez des champs spécifiques (logs JSON) :

user_id:usr_123abc
level:ERROR
status_code:500

Combiner les Recherches​

Utilisez AND, OR, NOT :

level:ERROR AND service:api
"timeout" OR "connection refused"
NOT level:DEBUG

Recherche Regex​

Utilisez des patterns regex :

/user_\d+/
/error.*timeout/i

Sélection de Période​

Choisissez des périodes prédéfinies :

  • 15 dernières minutes
  • Dernière heure
  • 6 dernières heures
  • 24 dernières heures
  • 7 derniers jours
  • Période personnalisée

Aller à un Moment​

  1. Cliquez sur le sélecteur de temps
  2. Entrez la date/heure spécifique
  3. Les logs sautent à ce moment

Mode Live​

Activez le mode live pour les logs en temps réel :

  • Les nouveaux logs apparaissent automatiquement
  • Défilement automatique vers les derniers
  • Cliquez pour mettre en pause

Streaming de logs en direct​

Vue d'ensemble​

SailOps supporte le streaming de logs en direct via Server-Sent Events (SSE). Contrairement au polling, le streaming en direct délivre les lignes de log dès leur production avec une latence inférieure à la seconde.

Lorsque le mode live est actif, les nouvelles lignes apparaissent en continu dans le visualiseur de logs. Le stream se reconnecte automatiquement en cas de coupure, et un heartbeat assure la détection des connexions obsolètes.

Fonctionnement​

  1. Ouvrez l'onglet Logs sur n'importe quelle ressource (conteneur, base de données, job, etc.) ou le Monitoring Center
  2. Activez le mode Live
  3. Les lignes de log apparaissent en temps réel à mesure qu'elles sont émises
  4. Cliquez sur Pause pour geler l'affichage — les lignes sont mises en tampon et apparaissent à la reprise

Filtres​

Le streaming en direct supporte les mêmes filtres que la recherche historique :

FiltreDescription
ProjectLimiter à un seul projet, ou streamer sur tous les projets de l'organisation
Workload typecontainer, job, cronjob, postgres, mariadb, valkey, opensearch, kafka, keycloak, wordpress, supabase, nats, custom (affichés lorsque le projet sélectionné contient ce type de ressource)
Workload nameFiltrer sur une ressource spécifique
InstanceFiltrer sur une instance de pod spécifique
Leveldebug, info, warning, error
Streamstdout ou stderr
QueryRecherche libre sur le message du log

Changer un filtre redémarre le stream avec les nouveaux critères.

Cycle de vie du stream​

  • Durée maximale : les streams sont automatiquement renouvelés après 2 heures. Le client reçoit un événement stream-rotating peu avant l'expiration et ouvre un nouveau stream de manière transparente.
  • Autorisation : votre session est périodiquement revérifiée. Si votre accès est révoqué en cours de stream, un événement stream-refused est envoyé et le stream se ferme.
  • Lignes perdues : lorsque le volume de logs dépasse la capacité du stream, le compteur dropped dans chaque événement vous indique le nombre de lignes écartées sur la fenêtre.

Pause et reprise​

  • Cliquez sur Pause pour arrêter le défilement automatique
  • Examinez les logs sans perdre les nouvelles entrées
  • Cliquez sur Reprendre pour continuer

Contexte des Logs​

Traçage des Requêtes​

Si votre app inclut des trace IDs :

{
"message": "Requête traitée",
"trace_id": "abc123",
"span_id": "def456"
}

Cliquez sur le trace ID pour voir tous les logs liés.

Instance du Conteneur​

Avec plusieurs réplicas :

[instance-1] Traitement de la requête...
[instance-2] Traitement de la requête...

Filtrez par instance pour isoler les logs.

Télécharger les Logs​

Téléchargez les logs correspondant à vos filtres actuels sous forme de fichier texte :

  1. Appliquez les filtres souhaités (projet, workload, niveau, stream, plage horaire, mot-clé)
  2. Cliquez sur le bouton Download .txt dans la barre d'outils du Log Explorer
  3. Le navigateur télécharge un fichier .txt contenant jusqu'à 100 000 de lignes de logs correspondantes

Le fichier exporté conserve le timestamp, le niveau, le projet, l'instance, le stream, l'image et le message de chaque entrée.

Rétention des Logs​

La rétention des logs dépend de votre plan de support :

PlanRétention
Basic7 jours
Starter30 jours
Business90 jours
CustomJusqu'à 730 jours

Les logs plus anciens que la période de rétention sont automatiquement supprimés. Les organisations avec un plan CUSTOM peuvent bénéficier de périodes de rétention négociées différentes des valeurs par défaut ci-dessus — votre rétention effective est visible dans les métadonnées de l'organisation et reflétée dans la plage temporelle du log explorer.

Bonnes Pratiques​

1. Utiliser le Logging Structuré​

// Mauvais - difficile à rechercher
console.log('User ' + userId + ' logged in from ' + ip);

// Bon - structuré et recherchable
console.log(JSON.stringify({
event: 'user_login',
user_id: userId,
ip_address: ip,
timestamp: new Date().toISOString()
}));

2. Inclure le Contexte​

Ajoutez du contexte utile aux logs :

logger.info('Commande créée', {
order_id: order.id,
user_id: user.id,
total: order.total,
items: order.items.length
});

3. Utiliser les Niveaux Appropriés​

UtilisationNiveau
Erreurs nécessitant actionERROR
Problèmes potentielsWARN
Opérations normalesINFO
Détails de développementDEBUG

4. Ajouter des Request IDs​

Tracez les requêtes entre services :

app.use((req, res, next) => {
req.requestId = uuid();
res.setHeader('X-Request-Id', req.requestId);
next();
});

// Inclure dans tous les logs
logger.info('Traitement de la requête', { request_id: req.requestId });

5. Ne Pas Logger de Données Sensibles​

Ne jamais logger :

  • Mots de passe
  • Clés API
  • Numéros de carte de crédit
  • Données personnelles (RGPD)
// Mauvais
logger.info('User login', { password: user.password });

// Bon
logger.info('User login', { user_id: user.id });

Logs de Base de Données​

Logs PostgreSQL​

Les logs de base de données incluent :

  • Statements - Requêtes lentes (> 1s)
  • Connections - Événements connexion/déconnexion
  • Errors - Erreurs de base de données
  • Warnings - Avertissements de performance

Niveaux de Log​

NiveauContenu
ERRORErreurs et crashs
WARNINGProblèmes potentiels
STATEMENTRequêtes lentes
CONNECTIONActivité des sessions

Log des Requêtes Lentes​

2024-01-15 10:30:45.123 UTC [1234] LOG:  duration: 5023.456 ms  statement: SELECT * FROM large_table

Logs de Gateway​

Logs d'Accès​

2024-01-15T10:30:45.123Z 200 GET /api/users 45ms 192.168.1.1 "Mozilla/5.0..."

Champs :

  • Timestamp
  • Code de statut
  • Méthode
  • Chemin
  • Durée
  • IP client
  • User agent

Logs d'Erreur​

2024-01-15T10:30:45.123Z 502 POST /api/orders 5023ms - upstream timeout

Dépannage​

Logs Non Affichés​

  1. Vérifiez que le conteneur est en cours d'exécution
  2. Vérifiez que votre app écrit sur stdout/stderr
  3. Attendez quelques secondes pour la collecte
  4. Rafraîchissez la page

Logs Manquants​

  1. Vérifiez la période de rétention
  2. Vérifiez la sélection de période
  3. Vérifiez les filtres de niveau

Problèmes de Parsing des Logs​

Si les logs JSON ne sont pas parsés :

  1. Vérifiez le format JSON valide
  2. Vérifiez les problèmes d'encodage
  3. Assurez-vous d'un objet JSON par ligne

Résultats tronqués dans Grafana​

Lorsqu'une requête de logs Grafana atteint son budget d'analyse interne, l'en-tête du panneau affiche un avertissement : « Results are partial: this query hit its scan budget. » Cela signifie que la fenêtre temporelle ou le filtre a trouvé plus de données que la requête ne peut en lire en une seule passe. Pour obtenir l'ensemble complet des résultats, réduisez la plage horaire ou ajoutez un filtre plus sélectif.

Problèmes de Performance​

Si le visualiseur de logs est lent :

  1. Réduisez la période
  2. Ajoutez des filtres
  3. Mettez en pause le mode live

Sujets Connexes​