cw-[ORG-ID]-audit-logs in your organization.
Audit logging supports the following use cases:
- Security and compliance teams: trace data access and administrative actions.
- Platform and storage admins: understand access patterns and debug incidents.
- Application engineers: correlate storage audit logs with application logs to investigate behavior during incidents.
Log types
Audit logging captures two types of events: control plane events and data plane events.Control plane logs
Control plane logs capture administrative and configuration-level events, including:- Key creation
- Key revocation
- Audit logging enabled for a bucket or for the organization
- Audit logging disabled
| Field | Description |
|---|---|
action | The action performed |
principal | The identity that performed the action |
principalRole | The role associated with the principal |
timestamp | When the action occurred |
identifier | The access key ID or bucket name, depending on the event |
duration_seconds | Duration of the action in seconds |
control-plane/ prefix in your organization’s audit logging bucket, partitioned by date and time.
Data plane logs
Data plane logs capture authenticated access to data, including:- Object operations such as puts, gets, and deletes
- Bucket operations such as bucket creation and listings
| Field | Description |
|---|---|
action | The operation performed |
aws:arn | The resource ARN; for object operations, includes the object key path |
principal | The identity ARN of the principal that performed the operation |
timestamp | When the operation occurred |
sourceIp | The source IP address of the request |
host | The HTTP Host header of the request |
bucketName | The name of the bucket |
accessKeyId | The access key ID used |
requestId | A correlation handle for logs and request traces |
data-plane/ prefix in your organization’s audit logging bucket, partitioned by date and time.
Log format and delivery
CoreWeave batches and compresses audit log events before writing them to the audit logging bucket. Events are written to a durable message queue and bundled at least every 15 minutes before persistence. The on-disk format is line-delimited JSON, where each line is a JSON object, stored in compressed files (.json or .json.gz). Object keys follow this format:
| Log type | Object key format |
|---|---|
| Control plane | control-plane/YYYY/MM/DD/HHMM+[ID].[FILE-FORMAT] |
| Data plane | data-plane/YYYY/MM/DD/HHMM+[ID].[FILE-FORMAT] |
- The order of events inside a bundle doesn’t necessarily match the order in which CoreWeave generated them.
- The order of bundles written to the audit logging bucket doesn’t reflect the precise generation order.
- A single request (for example, a multi-object delete) can generate multiple log entries.
Audit logging bucket
Each organization has one audit logging bucket, namedcw-[ORG-ID]-audit-logs, where [ORG-ID] is your organization ID. The bucket is isolated per organization and governed by your organization access policies and bucket access policies. You are responsible for managing the data in the bucket and pay storage fees for that data. For billing details, see Usage-based billing and pricing.
Configuration
Audit logging can be configured at the organization level or at the individual bucket level, so you can choose the right scope for your use case.| Scope | What it controls | API endpoint |
|---|---|---|
| Organization | Control plane events; data plane events for buckets created after the setting is enabled | SetOrganizationSettings |
| Bucket | Data plane events for a specific bucket | SetBucketSettings |
Enable audit logging
Enabling audit logging requires steps from both CoreWeave and your team. CoreWeave provisions your destination bucket and enables the feature on the backend. You configure the bucket access policy and logging settings.Prerequisites
Enabling audit logging requires two separate permissions:- To set the bucket access policy: An AI Object Storage Access Key and an organization access policy that allows
s3:PutBucketPolicyon thecw-[ORG-ID]-audit-logsbucket (ors3:*on all buckets). - To call the Object Storage API: The
Object Storage AdminIAM role and a CoreWeave API access token.
Steps
-
Contact CoreWeave support to request enablement, and include your organization name and Org ID.
Your Org ID is a short hexadecimal string (for example,
ab1cd2). Find it on the Settings page of your Cloud Console account. CoreWeave creates yourcw-[ORG-ID]-audit-logsdestination bucket as part of the enablement process. -
After CoreWeave creates the destination bucket, apply a bucket access policy granting the CoreWeave audit logging service account permission to write logs. The policy must grant at minimum
s3:ListBucketands3:PutObject. Replace[ORG-ID]with your organization ID.For instructions on applying this policy using S3 clients or Terraform, see Manage bucket access policies.audit-logging-bucket-access-policy.json - Notify CoreWeave that you’ve applied the bucket access policy, either by replying to your CoreWeave support ticket or by notifying CoreWeave through your support Slack channel. The CoreWeave admin then finishes enabling audit logging for your organization. After CoreWeave confirms that audit logging is enabled for your organization, you can choose which event types to capture.
-
Call the Object Storage API to enable the types of logs you want:
- Use organization-level settings to enable control plane logging, data plane logging for all buckets created after the setting is enabled, or both.
- Use bucket-level settings to enable data plane logging for a specific bucket only.
- Organization-level
- Bucket-level
Organization-level settings let you enable control plane logging, data plane logging for all buckets created after the setting is enabled, or both.Set the flags totrueorfalsebased on which event types you want to log:controlPlaneAuditLoggingEnabled: Control plane loggingbucketAuditLoggingEnabled: Data plane logging for buckets created after the setting is enabled
organization-settings.json:Submit the request:organization-settings.jsonA successful response returns the updated organization settings:Example requestResponse status code 200