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
- Naviguez vers votre conteneur
- Cliquez sur l'onglet Logs
- 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
| Niveau | Description | Couleur |
|---|---|---|
| ERROR | Erreurs nécessitant attention | Rouge |
| WARN | Problèmes potentiels | Jaune |
| INFO | Opérations normales | Bleu |
| DEBUG | Détails de debugging | Gris |
Filtrer par Niveau
- Cliquez sur le filtre Niveau
- 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
Navigation Temporelle
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
- Cliquez sur le sélecteur de temps
- Entrez la date/heure spécifique
- 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
- Ouvrez l'onglet Logs sur n'importe quelle ressource (conteneur, base de données, job, etc.) ou le Monitoring Center
- Activez le mode Live
- Les lignes de log apparaissent en temps réel à mesure qu'elles sont émises
- 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 :
| Filtre | Description |
|---|---|
| Project | Limiter à un seul projet, ou streamer sur tous les projets de l'organisation |
| Workload type | container, 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 name | Filtrer sur une ressource spécifique |
| Instance | Filtrer sur une instance de pod spécifique |
| Level | debug, info, warning, error |
| Stream | stdout ou stderr |
| Query | Recherche 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-rotatingpeu 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-refusedest envoyé et le stream se ferme. - Lignes perdues : lorsque le volume de logs dépasse la capacité du stream, le compteur
droppeddans 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 :
- Appliquez les filtres souhaités (projet, workload, niveau, stream, plage horaire, mot-clé)
- Cliquez sur le bouton Download .txt dans la barre d'outils du Log Explorer
- Le navigateur télécharge un fichier
.txtcontenant 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 :
| Plan | Rétention |
|---|---|
| Basic | 7 jours |
| Starter | 30 jours |
| Business | 90 jours |
| Custom | Jusqu'à 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
| Utilisation | Niveau |
|---|---|
| Erreurs nécessitant action | ERROR |
| Problèmes potentiels | WARN |
| Opérations normales | INFO |
| Détails de développement | DEBUG |
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
| Niveau | Contenu |
|---|---|
| ERROR | Erreurs et crashs |
| WARNING | Problèmes potentiels |
| STATEMENT | Requêtes lentes |
| CONNECTION | Activité 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
- Vérifiez que le conteneur est en cours d'exécution
- Vérifiez que votre app écrit sur stdout/stderr
- Attendez quelques secondes pour la collecte
- Rafraîchissez la page
Logs Manquants
- Vérifiez la période de rétention
- Vérifiez la sélection de période
- Vérifiez les filtres de niveau
Problèmes de Parsing des Logs
Si les logs JSON ne sont pas parsés :
- Vérifiez le format JSON valide
- Vérifiez les problèmes d'encodage
- 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 :
- Réduisez la période
- Ajoutez des filtres
- Mettez en pause le mode live