remote-logs

View logs from the remote development environment containers.

📋 TEMPLATE: This command is a template. Replace placeholders with your infrastructure values before use. See the Customization Guide at the bottom.

Workflow

1. Determine Log Mode

If argument contains --follow or -f:

• Stream logs in real-time
• Useful for monitoring deployments
• Press Ctrl+C to exit

If argument contains --tail N:

• Show last N lines
• Default to 100 if not specified

If no arguments:

• Show last 100 lines (default)

2. Execute Log Command

Get logs from all services:

# ┌─────────────────────────────────────────────────────────┐
# │ CUSTOMIZE: Replace with your SSH and project settings   │
# └─────────────────────────────────────────────────────────┘
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "cd {{PROJECT_PATH}} && ./scripts/dev-docker.sh logs --tail 100"

For specific service:

# Container names - customize for your project

# App logs (dev-mode - STANDARD port 3000)
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "docker logs {{APP_CONTAINER_DEV}} --tail 100"

# App logs (staging-mode - port 3001)
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "docker logs {{APP_CONTAINER_STAGING}} --tail 100"

# PostgreSQL logs (staging)
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "docker logs {{DB_CONTAINER_STAGING}} --tail 100"

# PostgreSQL logs (dev)
ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "docker logs {{DB_CONTAINER_DEV}} --tail 100"

3. Filter and Highlight

Parse logs for common patterns:

Error Detection:

• ERROR, Error, error
• FATAL, Fatal
• Exception, exception
• Stack traces

Warning Detection:

• WARN, Warning, warning
• deprecated

Success Markers:

• started, listening, ready
• connected, successful

Highlight critical issues in output.

4. Log Analysis

Provide quick analysis:

📋 Remote Dev Logs Analysis

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Dev Containers (STANDARD port {{DEV_PORT}})
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{{APP_CONTAINER_DEV}} (Node.js):
  Status:    ✅ Running
  Errors:    0
  Warnings:  2
  Last Line: [14:35:22] Ready on http://localhost:{{DEV_PORT}}

{{DB_CONTAINER_DEV}}:
  Status:    ✅ Running
  Errors:    0
  Last Line: [14:34:10] database system is ready

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Staging Containers (port {{STAGING_PORT}})
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{{APP_CONTAINER_STAGING}} (Node.js):
  Status:    ✅ Running
  Errors:    0
  Warnings:  1
  Last Line: [14:35:22] Ready on http://localhost:{{STAGING_PORT}}
  Recent warnings:
    [14:34:15] WARN: Using development build
    [14:34:18] WARN: App not initialized (missing config)

{{DB_CONTAINER_STAGING}}:
  Status:    ✅ Running
  Errors:    0
  Last Line: [14:34:10] database system is ready

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overall Health: ✅ Healthy
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Recommendation: No critical issues detected
Warnings are expected for dev environment