Skip to main content
With plerion audit-logs, you can view audit log entries for tenant operations including logins, API key creation, and other administrative actions.

​
Synopsis

plerion audit-logs list [options]

​
Subcommands

​
list

List audit log entries with filtering. 
plerion audit-logs list [options]

​
Options

FlagTypeDescription
--startISO 8601Start time (e.g. 2024-01-01T00:00:00Z)
--endISO 8601End time (e.g. 2024-01-31T23:59:59Z)
--user-idstringFilter by operator user ID
--operationstringFilter by operation type (e.g. UserLogin, CreatedApiKey)
--per-pagenumberResults per page (default: 50, max: 1000)
--allflagFetch all pages automatically

​
Examples

# Logs for January 2024
plerion audit-logs list --start 2024-01-01T00:00:00Z --end 2024-01-31T23:59:59Z

# All login events
plerion audit-logs list --operation UserLogin

# Logs by a specific user
plerion audit-logs list --user-id user-abc123 --output json

# Fetch all audit logs across all pages
plerion audit-logs list --all --output json

​
Output columns

Table output includes all fields returned by the API:
ColumnDescription
IDAudit log entry ID
OPERATIONOperation type (e.g. UserLogin, CreatedApiKey)
TIMEOperation timestamp
USER IDOperator user ID
EMAILOperator email address
IPIP address
USER AGENTBrowser/client user agent
COUNTRYCountry (from IP geolocation)
CITYCity (from IP geolocation)
REGIONRegion (from IP geolocation)
TENANT IDTenant ID
ORG IDOrganization ID