| name | implementing-velociraptor-for-ir-collection |
| description | Deploy and configure Velociraptor for scalable endpoint forensic artifact collection during incident response using VQL queries, hunts, and pre-built artifact packs across Windows, Linux, and macOS environments. |
| domain | cybersecurity |
| subdomain | incident-response |
| tags | ["velociraptor","dfir","endpoint-collection","vql","forensic-artifacts","rapid7","threat-hunting","incident-response"] |
| mitre_attack | ["T1059","T1003","T1070","T1547"] |
| version | 1.0 |
| author | mahipal |
| license | Apache-2.0 |
| d3fend_techniques | ["Executable Denylisting","Execution Isolation","File Metadata Consistency Validation","Content Format Conversion","File Content Analysis"] |
| nist_csf | ["RS.MA-01","RS.MA-02","RS.AN-03","RC.RP-01"] |
Implementing Velociraptor for IR Collection
Overview
Velociraptor is an advanced open-source endpoint monitoring, digital forensics, and incident response platform developed by Rapid7. It uses the Velociraptor Query Language (VQL) to create custom artifacts that collect, query, and monitor almost any aspect of an endpoint. Velociraptor enables incident response teams to rapidly collect and examine forensic artifacts from across a network, supporting large-scale deployments with minimal performance impact. The client-server architecture with Fleetspeak communication enables real-time data collection from thousands of endpoints simultaneously, with offline endpoints picking up hunts when they reconnect.
When to Use
- When deploying or configuring implementing velociraptor for ir collection capabilities in your environment
- When establishing security controls aligned to compliance requirements
- When building or improving security architecture for this domain
- When conducting security assessments that require this implementation
Common Misconfigurations & Verification
- Artifact scoping silently drops evidence: running
Windows.KapeFiles.Targets without the right target groups (_EventLogs, _Prefetch, _RegistryHives, _WebBrowsers) collects an incomplete triage and you won't know until analysis. Confirm the collection's row count and file manifest per host instead of assuming success.
- Hunt resource limits truncate results: the default per-client CPU/IOPS/timeout and
max_rows/max_upload_bytes caps cause VQL to return partial data on busy or large-disk hosts. Verify hunts completed with flow_state = "FINISHED" (not errored/timed-out) and re-scope or raise limits for endpoints that hit the cap.
- Offline endpoints aren't "clean", just absent: a hunt only covers clients that checked in. Reconcile hunt participation against your asset inventory and confirm laggards collect on reconnect — a 60% participation rate is a coverage gap, not a negative result.
- Over-broad VQL/
glob regex misses or floods: an MFT FileRegex or EvtxHunter IDRegex that's too narrow skips the IDs you need (4624/4648/4672/4688/4698/4769/5145); too broad and the upload buries the signal. Validate the regex against a known-positive host first.
- Concrete verification the deployment worked: confirm clients show
Online/last-seen current in the GUI, test an end-to-end collection on a canary host and check the artifact lands in the filestore with a non-zero hash, validate client config enrollment (correct server URL/CA), and confirm SIEM/Elastic output is actually indexing rows before relying on monitoring artifacts.
