Events

The runs (individual program invocations) behind a machine's events

Returns a machine's runs, newest first: one entry per invocation of an instrumented program, with what was run, when it was first and last seen reporting, how many distinct events it produced and how many occurrences those add up to. Values that look like passwords, tokens or keys are masked in the command line. Use run_uid with the events query's advanced builder - {"field":"run","op":"is","value":"<run_uid>"} on the python view - to narrow the events list, an export or the map to that one run; under that filter the count on each event is that run's own occurrences rather than the event's all-time total. A run_uid is empty on runs reported by agents that predate run ids, which are grouped by command line and environment instead: several invocations then share one entry. Ownership is a predicate in the query, so a machine secret belonging to another account returns an empty list, never that account's runs. Page with next_before: pass it back as before until it comes back empty.

This is a read: a read-only API key may call it.

get/api/runs/

Request

  • Base URL: https://eyalsec.com
  • URL: https://eyalsec.com/api/runs/
  • Auth: one of:
    • API key in header X-API-Key
    • API key in cookie __Host-es2session

Query parameters

secretstring uuid

Restrict to one machine by its secret (from GET /api/get_all_machines/). Omitted = every machine on the account.

machinestring

Restrict to one machine by display name (exact match), the same name the events query's machine filter takes.

qstring

Case-insensitive substring of the command line.

beforestring

Pagination cursor: the next_before of the previous page, passed back unchanged (it is opaque, not a bare timestamp). An unparseable value is treated as the first page rather than a 400.

limitinteger

Rows per page, 1-200 (default and maximum 200).

Response

OK.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.