---

name: monitoring description: Monitor Hawk job status, view logs, and diagnose issues. Use when the user wants to check job progress, view error logs, debug a failing job, or generate a monitoring report for a Hawk evaluation run.

Hawk Job Monitoring

Monitor running or completed Hawk jobs using the hawk logs command or hawk status subcommands.

Job ID

The JOB_ID parameter is the eval_set_id or scan_run_id from when the job was submitted.

JOB_ID is optional. If omitted, uses the last eval set ID that was used or received.

Available Commands

1. View Logs (Shorthand)

The hawk logs command shows logs:

Copyhawk logs                             # Show last 100 logs (all types)
hawk logs <JOB_ID>                    # Show last 100 logs for job
hawk logs -n 50                       # Show last 50 lines

Options:

• -n, --lines N - Number of lines to show (default: 100)

Note: Do NOT use the -f/--follow flag - it blocks indefinitely and is intended for interactive terminal use only.

2. View status

Generate a full monitoring report with logs, metrics, and other details:

Copyhawk status                           # Use last job ID
hawk status <JOB_ID>                  # Print report to stdout
hawk status <JOB_ID> > report.json      # Save to file

Options:

• --hours {hours} - Fetch logs from last N hours (default: 24 hours)

Common Workflows

Check job progress

Copyhawk logs

Generate full report for analysis

Copyhawk status > report.status