Skip to content

v1.4.0 - Tool 7: Scan Status Monitoring

Latest

Choose a tag to compare

@ABMJ ABMJ released this 24 Jun 11:39
· 2 commits to main since this release

🎉 Release v1.4.0: Scan Status Monitoring

New Features

Tool 7: tsc_scan_status - Real-Time Scan Execution Monitoring

  • 📊 Progress Tracking: IPs/hour rate, percent complete, ETA calculation
  • ⚠️ Import Status Alerts: Detect completed scans with running imports (data not available yet)
  • ⏱️ Time Range Filtering: Monitor scans from last 24h, 7d, or 30d
  • 📈 Performance Metrics: Scan duration, scanning rate, completion times
  • 🔍 Status Filtering: Filter by running/completed/error/stopped/paused
  • 🎯 Specific Scan Tracking: Query individual scan results by ID

Use Cases

  • Monitor active scan progress in real-time
  • Identify import issues (completed scans but data not imported)
  • Calculate scan completion time estimates
  • Troubleshoot failed scans
  • Track historical scan performance

Implementation Details

  • Module: src/tenable_sc_mcp/tools/scanning.py (377 lines)
  • Cache TTL: 60s (real-time monitoring data)
  • Token Efficiency: 700-1,900 tokens per query (avg 1,320)
  • Tests: Helper function tests + integration tests (390 lines)

Documentation

  • USER_GUIDE.md Section 9: Complete tool documentation with examples
  • TEST_PROMPTS.md Tool 7: 5 comprehensive test scenarios
  • HANDOFF.md: Updated for next session (Tool 8 - Compliance Summary)
  • TOOLS_ROADMAP.md: Progress tracking (9/27 tools = 33%)

Progress

  • Tools Complete: 9/27 (33%)
  • Next Priority: Tool 8 - Compliance Summary

Files Changed

  • Added: src/tenable_sc_mcp/tools/scanning.py
  • Added: tests/test_scanning.py
  • Updated: USER_GUIDE.md, TEST_PROMPTS.md, HANDOFF.md, TOOLS_ROADMAP.md, tenable-sc-mcp-server.md

Docker Deployment

✅ Both containers rebuilt and verified with v1.4.0 code

  • MCP Server: Port 8000
  • Redis Cache: Port 6379

Full Changelog: v1.3.1...v1.4.0