Flowmaker SDK [beta]Docs
search
GitHub

View Logs (./fm logs)

View logs for a FlowMaker instance or specific service.

./fm logs <name> [service]

Overview

The logs command shows Docker container logs with the following options:

  • View all services for an instance
  • View a specific service
  • Follow logs in real-time (default)

Examples

View All Instance Logs

$ ./fm logs dev
ℹ Viewing logs for instance 'dev'...
flowmaker-scheduler-1  | { timestamp: '2024-01-15T10:30:00Z', level: 'info', message: 'Scheduler started' }
flowmaker-confighub-1  | { timestamp: '2024-01-15T10:30:01Z', level: 'info', message: 'ConfigHub listening on port 4000' }
flowmaker-logging-1    | { timestamp: '2024-01-15T10:30:02Z', level: 'info', message: 'Logging service ready' }
flowmaker-frontend-1   | { timestamp: '2024-01-15T10:30:03Z', level: 'info', message: 'Frontend server running' }
^C

View Specific Service Logs

$ ./fm logs dev flowmaker-scheduler
ℹ Viewing logs for service 'flowmaker-scheduler'...
flowmaker-scheduler-1  | { timestamp: '2024-01-15T10:30:00Z', level: 'info', message: 'Scheduler started' }
flowmaker-scheduler-1  | { timestamp: '2024-01-15T10:31:00Z', level: 'info', message: 'Worker registered: worker-timer001' }
flowmaker-scheduler-1  | { timestamp: '2024-01-15T10:32:00Z', level: 'debug', message: 'Flow executed: flow-123' }

View Worker Logs

$ ./fm logs dev worker-timer
ℹ Viewing logs for service 'worker-timer'...
worker-timer-1  | { timestamp: '2024-01-15T10:30:05Z', level: 'info', message: 'Worker connected to scheduler' }
worker-timer-1  | { timestamp: '2024-01-15T10:30:10Z', level: 'info', message: 'Emitting timer event' }

Behavior

[NOTE!info/FOLLOW MODE] Logs are shown in follow mode by default (equivalent to docker logs -f). Press Ctrl+C to stop following.

Compose Files Used:

  • docker-compose.yml
  • docker-compose.datacatalog.yml
  • docker-compose.workers.yml

Common Use Cases

Debug Service Startup Issues

./fm logs dev flowmaker-scheduler

Monitor Worker Activity

./fm logs dev worker-timer

Check for Errors

./fm logs dev | grep -i error

View Recent Logs Only

# In another terminal, run:
./fm logs dev | tail -50

Troubleshooting

No Logs Showing

# Check if service is running
./fm ps dev | grep <service-name>

# Restart service
./fm down dev
./fm up dev --workers

Logs Too Verbose

# Filter by log level
./fm logs dev | grep level:

# Filter by service
./fm logs dev flowmaker-scheduler

Check Specific Error

./fm logs dev | grep -A 5 -B 5 "error"

Related Commands

Command Description
./fm logs <name> View all instance logs
./fm logs <name> <service> View specific service logs
./fm ps <name> List containers
docker compose -p fm-dev logs -f Direct Docker Compose alternative

References