Cloud CLI : commande Logs

Exécutez mcloud logs pour récupérer les logs runtime d'un backend ou d'une storefront d'environnement Cloud.

Contraintes

• --follow et --json sont incompatibles. Pour l'analyse programmatique des logs, utilisez des fenêtres de temps délimitées avec --from/--to et --json.
• --follow diffuse en continu jusqu'à interruption avec Ctrl+C — ne l'utilisez pas dans les scripts ou pipelines.
• Par défaut, récupère les 500 dernières lignes de log des 15 dernières minutes.

Commande

mcloud logs \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle> \
  [options]

Options

Exemples

# Récupération basique (500 dernières lignes, 15 dernières min)
mcloud logs --json

# Rechercher les erreurs
mcloud logs --search error --limit 1000 --json

# Filtrer les erreurs HTTP 500 via métadonnées
mcloud logs --metadata status=500 --limit 1000 --json

# Logs pour un deployment spécifique (ID build ou deployment)
mcloud logs --deployment bld_01ABC123 --json

# Sortie structurée pour analyse agent
mcloud logs --search error --json | jq '.[] | {timestamp, source, message}'

# Logs storefront
mcloud logs --type storefront --json

# Diffuser les logs en direct (lisible, pas pour les scripts)
mcloud logs --follow

# Logs dans une plage horaire spécifique
mcloud logs --from 2026-04-22T10:00:00Z --to 2026-04-22T11:00:00Z --limit 1000 --json

# Logs depuis un moment jusqu'à maintenant
mcloud logs --from 2026-04-22T10:00:00Z --json

# Filtres de source multiples
mcloud logs --source api --source worker --json

# Filtres de métadonnées multiples (HTTP 4xx et 5xx)
mcloud logs --metadata status=400 --metadata status=500 --limit 500 --json

Notes sur la plage horaire

• La fenêtre par défaut est les 15 dernières minutes.
• Passez --from sans --to pour récupérer à partir d'un moment jusqu'à maintenant.
• Passez --to sans --from uniquement si --to est dans les 15 dernières minutes; sinon passez aussi --from.
• --from et --to acceptent tous deux les timestamps ISO 8601.