Skip to main content

How audit works

Audit is where your organization's history lives. It answers two questions: who did what, and what did an agent do while it worked on a task. Everything in it is read-only — you can search, filter and download, but nothing you do here changes a task, a project or a setting. Open it from Audit in the sidebar.

Two records​

Activity lists every action taken in your organization, newest first: a person creating a task, changing a project, inviting someone, or Jaah acting on its own (shown as System). Each action records who took it, when, what it touched and how it ended, and opens to its full details. You can narrow the list to one person, one record such as a task or a credential, or one browser sign-in, and choose between Changes, Views or All.

Sessions lists every time an agent worked on a task. A task can run more than once — after a stop, a restart or a failed attempt — and each run is its own session, with the node it ran on, how long it took, how many tokens it used and why it ended. A run that ended before it could start a session still appears, under Attempts with no session, so a task that never got going is not invisible. Efficiency sums the agents' time over 7, 14 or 30 days and shows where it went.

How it fits with the rest of Jaah​

  • From a task, its sessions open filtered to that task, so you can follow one piece of work across all its runs.
  • A session names the node it ran on, which helps when one machine keeps ending runs the same way.
  • What you see follows your roles and groups: viewing Activity and viewing Sessions are separate permissions, and downloading a transcript needs a role that can download transcripts. Activity is shown when your plan includes Audit, and Sessions when it includes Session transcripts.

A session's states​

A session is Running while the agent works and Ended once it stops; one whose status was never settled reads Unknown. A session that was sent to a node but never started never ends on its own; Audit calls these stale and offers to delete them.

Its transcript moves through its own states, from pending to uploaded; see Transcript states.

Secrets are removed from a transcript before you download it, but only those Jaah recognizes, so treat every transcript as if it still holds credentials and customer data.