-
Notifications
You must be signed in to change notification settings - Fork 258
docs(add): audit trail export to bucket feature #5782
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
a11e440
docs(add): doc
nerda-codes d959752
docs(add): adt export
nerda-codes 96eec9e
docs(add): faq billing question
nerda-codes 8b4f795
docs(fix): feedback mathias
nerda-codes e99f8b9
docs(add): ro review
nerda-codes d03e219
docs(add): storage class specs
nerda-codes File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,68 @@ | ||
| --- | ||
| title: How to create and manage Audit Trail exports | ||
| description: Learn how to export your Audit Trail event logs to your Object Storage bucket, retrieve your export, and securely manage your data | ||
| tags: audit-trail events track filter export-to-bucket | ||
| dates: | ||
| validation: 2025-11-13 | ||
| posted: 2025-11-13 | ||
| --- | ||
|
|
||
| import Requirements from '@macros/iam/requirements.mdx' | ||
|
|
||
| This page shows you how to export your Audit Trail event logs to an Object Storage bucket, and retrieve an export using the [Scaleway console](https://console.scaleway.com/). | ||
nerda-codes marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| By default, your event logs are exported to the `Standard` [storage class](/object-storage/concepts/#storage-class) or to the storage class you have selected upon bucket creation. | ||
|
|
||
| <Requirements /> | ||
|
|
||
| - A Scaleway account logged into the [console](https://console.scaleway.com) | ||
| - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization | ||
| - Created [resources integrated](/audit-trail/reference-content/resource-integration-with-adt/) with Audit Trail | ||
| - [Created](/object-storage/how-to/create-a-bucket/) an Object Storage bucket with [object lock](/object-storage/api-cli/object-lock/#how-to-configure-bucket-lock) set up | ||
|
|
||
| <Message type="note"> | ||
| At this stage, an export includes all Audit Trail events by default, allowing only one active export configuration per region. Future updates will let you select specific events for export. | ||
| </Message> | ||
|
|
||
| ## How to create an export | ||
|
|
||
| 1. Click **Audit Trail** in the **Monitoring** section of the [Scaleway console](https://console.scaleway.com/) side menu. | ||
| 2. Click the **Region** drop-down and select a region in which you have Audit Trail events. | ||
| 3. Click **Create export**. You are prompted to create an event export. | ||
| 4. Fill out the required information to configure your **destination bucket**: | ||
| 1. In the **Bucket region** drop-down, select the region in which you have created your bucket. | ||
| 2. In the **Bucket project** drop-down, select the Scaleway project in which you have created your bucket. | ||
| 3. In the **Destination bucket** drop-down, select your bucket. | ||
| 4. In the **Prefix** field, enter a [prefix](/audit-trail/concepts/#prefix) to define the folder path where your event logs will be stored. | ||
| 5. Click **Next** to move on to the Audit Trail export creation step. | ||
| 5. Enter a name and optional tags for the Audit Trail export, then click **Next**. | ||
| 6. Review your export configuration and click **Create export** to confirm. Your export displays in the **Exports** tab. | ||
| <Message type="note"> | ||
| The first Audit Trail export includes data from the past 90 days and may take a few minutes to complete. | ||
| </Message> | ||
|
|
||
| ## How to retrieve and manage an export | ||
|
|
||
| 1. Click **Object Storage** in the **Storage** section of the [Scaleway console](https://console.scaleway.com/) side menu. | ||
| 2. Click the **Region** drop-down and select the region in which you have created your destination bucket. | ||
| 3. Click your destination bucket. | ||
| Your Audit Trail export folder displays. Inside this folder, you will find a `2025` folder (corresponding to the year), in which you will find three other folders, for example, `09`, `10`, and `11` (corresponding to the last 3 months). Each of these folders contains a `DD` folder corresponding to the day the event logs happened. Your Audit Trail export is located inside the `DD` folder, as a JSON file. | ||
| 4. Access the `YYYY` folder, the desired `MM` folder, and the `DD` folder. Your export should display as follows: `logs_xxxxxxxxx.json`. | ||
| 5. Click the <Icon name="download" /> icon to download your export. | ||
| 6. Optionally, click the <Icon name="seeMore" /> icon and click: | ||
| 1. **More info** to display object information | ||
| 2. **Visibility** to change your [object visibility](/object-storage/concepts/#visibility) | ||
| 3. **Object metadata** to add information. | ||
| 4. **Object tags** to add tags | ||
| 5. **Edit name** to update the name of your file | ||
| 6. **Get public link** to publicly share your file | ||
| 7. **Delete** to delete your export **from the bucket** | ||
|
|
||
|
|
||
| ## How to delete an export | ||
|
|
||
| 1. Click **Audit Trail** in the **Monitoring** section of the [Scaleway console](https://console.scaleway.com/) side menu. | ||
| 2. Click the **Region** drop-down and select the region in which you have created your Audit Trail export. | ||
| 3. Click the **Exports** tab. Your export displays. | ||
| 4. Click the <Icon name="delete" /> icon to delete your export. | ||
| 5. Type **DELETE** and click **Delete export** to confirm. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.