Networks, devices, and sensors · GraphQL type

SensorRequestRun type

The record of one attempt to run a SensorRequest: when it ran, which sensor version ran it, which Endpoint ran it (none for PUBLIC-zone runs, which the vendor system performs), how it ended, and the open ports and network services it reported. The system records a run for every attempt, whatever its result; only a COMPLETED run updates the Service and OpenPort objects in the graph. Reach runs through SensorRequest.runs, Device.sensorRequestRuns, or sensorRequestRun.

Fields

Field Name Description
id - ID! A string uniquely identifying this SensorRequestRun.
sensorRequestId - ID! The unique identifier of the SensorRequest that was run.
sensorRequest - SensorRequest! The SensorRequest that was run.
timestamp - Time! Time the run completed.
version - String! The version of the software that ran the request.
device - Device! The Device the sensor request was run against.
endpoint - Endpoint The Endpoint that performed this run. Null for PUBLIC-zone runs, which the vendor system performs, and when the Endpoint no longer exists.
result - SensorRequestRunResult! Reports the end state of the request run.
errors - [String!] A list of errors encountered during the run.
ports - [OpenPortSummary!] Summary of the ports the run reported, open or closed.
services - [ServiceSummary!] Summary of the network services the run reported, up or down.
portsFound - Int! The number of entries in ports that were open.
servicesFound - Int! The number of entries in services that were up.

Returned by

  • sensorRequestRun query: Retrieves a SensorRequestRun: the record of one attempt to run a SensorRequest, with its outcome, the endpoint that ran it when one did, and the…

Used by

  • Device type: A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
  • SensorRequest type: A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.
  • SensorRequestRunPayload type: Payload wrapper for a single SensorRequestRun result.

Related types

  • Device A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as…
  • Endpoint A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
  • SensorRequest A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.

Example

Example

{
  "id": "4",
  "sensorRequestId": 4,
  "sensorRequest": SensorRequest,
  "timestamp": "2021-10-07T18:23:25.829Z",
  "version": "abc123",
  "device": Device,
  "endpoint": Endpoint,
  "result": "COMPLETED",
  "errors": ["xyz789"],
  "ports": [OpenPortSummary],
  "services": [ServiceSummary],
  "portsFound": 123,
  "servicesFound": 987
}