Skip to main content
Reading the audit log requires the View audit log permission, which every role except Billing manager holds. Navigate to the Audit page from the sidebar.
Audit log

What Is Recorded

The audit log records any significant activities across your entire workspace, including user sign-ins, data exports, plan executions, and API key creation. Every log entry contains:
  • Actor: Who performed the action, with their IP address and user agent.
  • Action: What they did.
  • Event type and target: What was acted upon.
  • Time: When it happened.
  • Via: How the action was performed (via the web app, via the API, or via MCP).
  • Conversation: The AI chat assistant conversation the action belongs to, if any.
  • Trace ID: A handle for support to troubleshoot issues.

Actor Types

Filter the Log

Use the toolbar to narrow the feed:
  • Action: A single recorded activity. See Actions for a list.
  • Event type: One or more kinds of target. See Event types for a list.
  • Actor: One or more members.
  • Date range: A start and end date.
  • Target: An affected entity such as a worker, connection, or the workspace itself.
  • Via: One or more of Web app, API, and MCP.
To reset all filters, click the Clear button in the toolbar.
Audit log filters

Export the Log as a CSV

1
Navigate to the Audit page from the sidebar.
2
Click on the menu button in the top-right corner.
3
Click Export.
4
Choose a date range and click Export.

Send the Log to Your SIEM

Klef sends the audit log to your SIEM, such as Splunk, Datadog, Panther, CrowdStrike, or Microsoft Sentinel, as OCSF v1.9.0 events. Klef can write it to your own S3-compatible bucket, so you hold an immutable copy, or your SIEM can pull it through the API.

Through Your Bucket

Every few minutes, Klef seals new records into a batch and writes it to:
To configure:
1
Create a bucket and a key that can only write objects (see below).
2
Navigate to Settings > Workspace.
3
Under Audit log delivery, enter the endpoint, region, bucket, folder, and key.
4
Click Turn on.
Klef writes a test object to {folder}/_klef/ and tries to delete it. It won’t save a key that can delete objects. Only the Owner role can set up delivery. If delivery fails for an hour, owners will be notified via email.

Amazon S3

Set Endpoint to your bucket’s regional endpoint (e.g. https://s3.us-east-1.amazonaws.com). Then set two policies: an IAM policy on the key, and a bucket policy on the bucket.
1

Attach an IAM policy to the key

Create an IAM user specific to Klef and attach only this IAM policy to that user or role. It lets the key write objects and nothing else:
2

Add a bucket policy

Add this bucket policy under the bucket’s Permissions > Bucket policy. It stops any key from overwriting a batch:
3

Turn on Object Lock (optional)

For write-once storage, turn on Object Lock with a default retention when creating the bucket.

Cloudflare R2

R2 tokens can’t be write-only, so lock the bucket instead: under the bucket’s Settings, add a Bucket lock rule for the folder. Then create an Object Read & Write API token for the bucket. Set Endpoint to https://<account ID>.r2.cloudflarestorage.com and Region to auto.

Other providers

Set Endpoint to the provider’s S3 endpoint. The provider must support conditional writes (If-None-Match). Use a key that can only write objects, or lock the bucket. If the provider can refuse writes without If-None-Match, turn that on too, so a batch can’t be overwritten.

Through the API

Poll GET /audit with an API key that can view the audit log. Start with afterSequence=0, then pass the last record’s unmapped.klef.sequence and metadata.uid as afterSequence and afterId. You get every record exactly once, oldest first, up to 10 minutes after the event happens.

Change How Long Records Are Kept

Records are kept for 2 years by default.
1
Navigate to Settings > Workspace.
2
Open Audit log retention.
3
Choose the new retention period, which spans from 30 days to 7 years, or Forever to keep records indefinitely.
4
Click Save.
Only the Owner role can change retention.

Reference

Event Types

Actions

The Action filter groups every activity the log records.

Roles and Permissions

Which roles can view the audit log.