RocketCyber Agent Management

Overview

RocketAgent is the endpoint agent deployed by RocketCyber to customer workstations and servers. It provides the telemetry pipeline for threat detection -- collecting event data, monitoring processes, and reporting back to the RocketCyber SOC platform. Agent health directly impacts the MSP's security coverage.

Key agent functions:

• Threat Telemetry - Collects endpoint events (process execution, file changes, network connections)
• SOC Communication - Reports events to RocketCyber's cloud analysis engine
• Endpoint Visibility - Provides the SOC with real-time endpoint status
• Detection Coverage - Endpoints without healthy agents have no SOC coverage

Key Concepts

Agent Lifecycle

┌──────────────┐    Deploy    ┌────────────┐    Checks In    ┌──────────┐
│  Unmanaged   │ ──────────>  │ Installed  │ ─────────────>  │  Online  │
│  Endpoint    │              │ (Pending)  │                 │          │
└──────────────┘              └────────────┘                 └──────────┘
                                                                  │
                                                    Communication │ Lost
                                                                  ▼
                                                             ┌──────────┐
                                                             │ Offline  │
                                                             └──────────┘

Communication Status

Agent Types and Platforms

RocketAgent supports multiple platforms (verify against current documentation):

Field Reference

Note: Field names are inferred from the Celerium PowerShell wrapper. Verify exact field names against RocketCyber API responses.

API Patterns

List All Agents

# All agents across all accounts
curl -s "https://api-${ROCKETCYBER_REGION:-us}.rocketcyber.com/v3/agents" \
  -H "Authorization: Bearer ${ROCKETCYBER_API_KEY}"

Response (verify against API docs):

{
  "data": [
    {
      "id": 5001,
      "hostname": "WORKSTATION-01",
      "accountId": 12345,
      "platform": "Windows",
      "status": "Online",
      "lastSeen": "2026-02-23T10:15:00Z",
      "agentVersion": "3.2.1"
    }
  ],
  "totalCount": 350,
  "page": 1,
  "limit": 50
}

Filter Agents by Account

# Agents for a specific customer
curl -s "https://api-us.rocketcyber.com/v3/agents?accountId=12345" \
  -H "Authorization: Bearer ${ROCKETCYBER_API_KEY}"

Get Agent Details

# Single agent with full details
curl -s "https://api-us.rocketcyber.com/v3/agents/5001" \
  -H "Authorization: Bearer ${ROCKETCYBER_API_KEY}"

Response (verify against API docs):

{
  "id": 5001,
  "hostname": "WORKSTATION-01",
  "accountId": 12345,
  "accountName": "Acme Corporation",
  "platform": "Windows",
  "osVersion": "Windows 11 Pro 23H2",
  "status": "Online",
  "lastSeen": "2026-02-23T10:15:00Z",
  "agentVersion": "3.2.1",
  "ipAddress": "192.168.1.50",
  "installedAt": "2025-06-15T09:00:00Z"
}

Common Workflows

Agent Health Audit

1. List all agents -- retrieve full agent inventory
2. Identify offline agents -- filter for status=Offline or agents not seen recently
3. Group by account -- identify which customers have coverage gaps
4. Calculate coverage -- compare agent count to expected endpoint count
5. Report findings -- generate per-customer agent health summary

Troubleshooting Offline Agents

When an agent shows as Offline:

1. Check last seen timestamp -- determine how long the agent has been offline
2. Verify endpoint is powered on -- check with RMM tool (Datto RMM, NinjaOne, etc.)
3. Check RocketAgent service -- verify the service is running on the endpoint

   Get-Service -Name "RocketAgent" | Select-Object Status, StartType

1. Check network connectivity -- verify endpoint can reach *.rocketcyber.com
2. Check agent version -- outdated agents may have communication issues
3. Reinstall if needed -- redeploy the agent from the RocketCyber console

New Customer Onboarding

1. Create customer account in RocketCyber (or verify it exists)
2. Download agent installer from the RocketCyber console for the customer account
3. Deploy agents to all customer endpoints via RMM tool or manual installation
4. Verify agents check in -- confirm all agents show Online status
5. Validate coverage -- ensure agent count matches expected endpoint count

Agent Version Compliance

1. List all agents across accounts
2. Group by agentVersion
3. Identify agents on outdated versions
4. Plan upgrade rollout for non-current agents

Error Handling

Common Errors

No Agents Found

No agents found for account ID 12345.

This could mean:
- Agents have not been deployed to this customer
- The account ID is incorrect (verify with /accounts endpoint)
- Agents were recently removed

Related Skills

• api-patterns - Authentication, pagination, error handling
• incidents - Incidents reference affected devices/agents
• accounts - Account hierarchy (agent-to-account mapping)
• apps - Applications detected on agent endpoints