Skip to content

docs(endpoint-commands): correct os_processes and netstat response events - #447

Open
tekgrunt wants to merge 1 commit into
masterfrom
docs/endpoint-commands-rep-events
Open

tekgrunt wants to merge 1 commit into
masterfrom
docs/endpoint-commands-rep-events

Conversation

@tekgrunt

Copy link
Copy Markdown
Contributor

What's wrong today

The Endpoint Commands reference gives the wrong response event for two commands:

  • os_processes says EXISTING_PROCESS (multiple events, one per process). The sensor actually answers with a single OS_PROCESSES_REP whose PROCESSES list holds every running process.
  • netstat says NETWORK_CONNECTIONS. The sensor actually answers with a single NETSTAT_REP whose NETWORK_ACTIVITY list holds each connection.

The netstat sample response also used field names the sensor doesn't send (LOCAL_ADDRESS, LOCAL_PORT, REMOTE_ADDRESS, REMOTE_PORT, PID, PROCESS, and a string STATE).

The change

  • Both Response Event lines now name the _REP event and say what the list holds.
  • Both sample responses now show the real shapes: os_processes returns a PROCESSES list; netstat returns SOURCE/DESTINATION objects, PROCESS_ID, PROTOCOL and a numeric STATE.

This matches the EDR Events reference, which already lists OS_PROCESSES_REP and NETSTAT_REP.

How it was verified

On 2026-09-24, both commands were tasked on Endpoint Agent 5.3.9 sensors:

Sensor os_processes reply netstat reply
Linux (Ubuntu 22.04) OS_PROCESSES_REP, 98 processes NETSTAT_REP, 12 connections
Windows OS_PROCESSES_REP, 84 processes NETSTAT_REP, 56 connections

No EXISTING_PROCESS events came back for either command. The periodic NETWORK_CONNECTIONS events seen on the Linux host carry no investigation ID, so they are the sensor's regular telemetry, not the netstat reply.

Not verified: macOS (no Mac sensor available).

mkdocs build --strict passes and pytest tests/ passes (215 tests).

🤖 Generated with Claude Code

https://claude.ai/code/session_01X6h9smaXGQuviYJPcGFAkQ

…ents

os_processes answers with a single OS_PROCESSES_REP whose PROCESSES list holds
every running process, not one EXISTING_PROCESS event per process. netstat
answers with a single NETSTAT_REP whose NETWORK_ACTIVITY list holds each
connection, not NETWORK_CONNECTIONS. Both sample responses now show the fields
the sensor actually sends (SOURCE/DESTINATION objects, PROCESS_ID, PROTOCOL and
a numeric STATE for netstat; the PROCESSES list for os_processes).

Verified 2026-09-24 against Endpoint Agent 5.3.9 by tasking both commands on a
Linux and a Windows sensor: the replies were OS_PROCESSES_REP (98 and 84
processes) and NETSTAT_REP (12 and 56 connections), with no EXISTING_PROCESS
events. This matches the EDR Events reference, which already lists both _REP
events.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X6h9smaXGQuviYJPcGFAkQ
@limacharlie-refractionpoint

Copy link
Copy Markdown

LimaCharlie Cloud Security — code scan

No new code findings were introduced by this pull request.

This check reports and never fails: no gating.fail_on is set on the code_scanning policy.

Scanned refractionPOINT/documentation 278f605…c2613dc — only findings new in the head commit are listed; anything already on the base branch is the repository's own finding set, on the Cloud Security Code page.

This comment is updated in place on every push to this pull request.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant