---
title: "audit session"
description: "Summarize one agent session's audit entries"
canonical: "https://pgbeam.com/docs/cli/audit/session"
last-updated: "2026-09-13T16:16:22.000Z"
---

# audit session

> Summarize one agent session's audit entries

URL: https://pgbeam.com/docs/cli/audit/session

Group one session's audit entries into a single summary: the credentials and origins involved, the window it spans, how many statements were allowed, blocked, masked and truncated, the rows and bytes it moved, and the tables it read, wrote and was refused. Session IDs come from the session\_id field of `pgbeam audit list --json`. The summary is computed from the audit log with no model involved, so the same entries always summarize the same way, and it carries table names and counts only, never row values. A session ID is unique per connection within a proxy instance and not over time, so narrow a reused one with --start and --end.

## Usage

## Options

Option

Description

Required

Default

`<session-id>`

Session ID from an audit entry

Yes

-

`--start <value>`

Only entries at or after this ISO 8601 timestamp (inclusive lower bound)

No

-

`--end <value>`

Only entries strictly older than this ISO 8601 timestamp (upper bound)

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Prints the session window, credentials and sources, the allowed/blocked/masked/truncated statement counts, rows and bytes returned, and the tables read, written, and blocked.