Audit

Coder maintains records of all user actions on system resources for auditing purposes.

Any user who is a Site Manager or an Auditor can log into Coder, go to Manage > Audit, and view the Audit Logs.

By default, this page displays a chronological list of all actions taken on the system.

You can filter the logs displayed using the search filters available at the top:

• Resource Type: The resource on which the action is taken (e.g., image, workspace, user)
• Action: The action that the user took against a resource (e.g., read, write, create)
• Resource Target: The friendly name for the resource (e.g., the user with the email address [email protected])
• User: The user who performs the action

Actions

The audit logs capture information about the following actions (those who export Coder logs will see this information under message.fields.audit_log.action):

When reviewing Coder's audit logs, specifically, you will see the following actions included:

• auto_off: Coder automatically turned off a workspace due to inactivity
• auto_start: Coder automatically turned on a workspace at the time preset by its owner
• connect: a user connected to an existing workspace via a local VS Code instance, a JetBrains IDE via JetBrains Gateway, a local terminal ssh connection, or a local terminal connection via the Coder CLI's coder ssh command
• cordon: a workspace provider became unavailable for new workspace creation requests
• create: the user created a Coder entity (e.g., dev URL, image/image tag, workspace, etc.)
• delete: a user deleted a Coder entity (e.g., workspace or image)
• enqueue: a user added a new job to the queue (e.g., workspace build, user deletion, workspace deletion)
• login: a user logs in via basic authentication or OIDC, with Coder exchanging a token as a result
• open: a user opened a workspace using the Code Web IDE through the browser (please note that this action is not yet logged for JetBrains IDEs)
• ssh: a user opened a web terminal to access Coder
• stop: a user manually stopped a workspace
• uncordon: a workspace provider became available for new workspace creation requests
• view: the Coder CLI used a secret
• write: the user made a change to a Coder entity (e.g., workspace, user, resource pool, etc.)

Admin logged events

With the exception of a few, logged events made by Admin panel changes will output the changed field(s) and the new, corresponding value. Below is the expected (example) output for each Admin panel change.

The Admin fields not documented below currently do not output a field/diff.

Infrastructure

Git OAuth

Appearance

Telemetry

Templates

The template policy dropdown will provide a unique commit/hash for the uploaded file. If file is uploaded from disk, then file path/git ref will be local.