Audit Logs

Audit logs provide a record of all actions taken in an Ona organization. Using the audit logs, you can track who performed an operation, on which resource, and when. Ona produces audit logs for all operations within an organization.

This feature is only available on the Enterprise tier.

Accessing Audit Logs

Audit logs are accessible to users with the Organization Owner role. You can retrieve audit logs using the Gitpod CLI or the API.

Using the CLI

You can view audit logs using the gitpod CLI, which is pre-installed on all Ona environments.

gitpod audit-logs [--limit=number_of_entries]

For additional options, including filtering and output formatting (JSON or YAML), run:

gitpod audit-logs --help

Example Output

➜ gitpod audit-logs

SUBJECT ID                           SUBJECT TYPE            ACTOR ID                             ACTOR PRINCIPAL       ACTION                       CREATED AT
01951d94-d6ac-7edf-9021-a044cfd1908f RESOURCE TYPE ENVIRONMENT 0193e2f2-d0b5-7d52-87eb-235deadaf625 PRINCIPAL RUNNER changed update_time, status, phase, last_running_session 2025-02-21T12:10:05Z
0194f5dd-01ca-75f4-a200-74381ed43f86 RESOURCE TYPE ENVIRONMENT 0193e2f2-d0b5-7d52-87eb-235deadaf625 PRINCIPAL RUNNER changed update_time, status, phase, last_running_session 2025-02-21T12:10:03Z
...

Using the API

You can retrieve audit logs programmatically via the API.

Example Request

curl https://app.gitpod.io/api/gitpod.v1.EventService/ListAuditLogs \
     -H 'Content-Type: application/json' \
     -H "Authorization: Bearer $GITPOD_API_KEY" \
     -d '{}'