Application Logs

Convoy Cloud automatically collects logs from your application's standard output (stdout) and standard error (stderr). Logs are stored in Loki and accessible through your Grafana workspace.

Viewing logs

During deployment

Build and deployment logs stream in real time on the deployment detail page. You can watch the entire build as it happens.

After deployment

Application runtime logs are in your Grafana workspace:

1. Click Observability in the sidebar.
2. Click the Application logs quick link — this opens Loki Explore in a new tab, pre-scoped to your workspace.
3. Pick the application you care about from the label filters.
4. Use the time range picker to narrow your search.

You can also click Open Grafana and navigate to the Logs Explorer dashboard manually.

Log features

• Full-text search — search across all logs for specific strings or patterns
• Time range filtering — view logs from the last 5 minutes, 1 hour, 24 hours, or a custom range
• Application filtering — filter by application
• Live tail — watch logs in real time as they are emitted

Writing logs

Convoy Cloud captures stdout and stderr. Write to these streams:

// Node.js
console.log('Request received:', req.method, req.url);
console.error('Database connection failed:', error.message);

# Python
import logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
logger.info(f"Request: {request.method} {request.url}")

For better searchability, use JSON structured logging:

console.log(JSON.stringify({
  level: 'info',
  message: 'Request handled',
  method: 'GET',
  path: '/api/users',
  duration_ms: 45,
  status: 200
}));

Log retention

Logs are retained for 7 days. Older logs are deleted automatically.

Build logs

Build logs are streamed during deployment and available on the deployment detail page after the build completes.