Skip to main content
Data exports send your workspace’s logs to a destination you own, on a schedule. Each export copies one source to one destination, such as an S3 bucket or a Splunk index. After the first run, each run sends only the data that arrived since the previous run.
  • Available on: Enterprise plans
  • Access: Workspace admins and owners
  • Location: Data exports (Workspace settings → Security → Data exports)

Why use data exports

Lovable keeps audit logs for 13 weeks. Data exports put a copy of that data in your own systems, where you control retention, access, and analysis. Use data exports when you want to:
  • Keep audit logs longer than 13 weeks, for example a multi-year audit trail in a bucket with your own lifecycle rules.
  • Search Lovable activity next to your other security events in a SIEM (security information and event management system), for example to alert when someone changes SSO settings or adds a workspace admin.
Use the Export button on the audit logs page instead when you need a one-time download. See Exporting audit logs.

Sources

Each export copies exactly one source. To export several sources, create one export per source. Every row has an id field. The id stays the same if Lovable delivers the row again, so you can use it to remove duplicates. See Delivery and duplicates.

Audit log fields

Each audit log row has these fields: Here is one audit log row, formatted for readability:

Destinations

Lovable supports three destinations. Object storage destinations receive files. Event destinations receive one event per row. None of the destinations need a long-lived password or access key, except Splunk. Lovable signs in to AWS and Azure with short-lived credentials that your cloud account trusts. For Splunk, you give Lovable an HTTP Event Collector token.

Object storage file layout

Amazon S3 receives gzipped JSON Lines files, one row per line. Lovable writes them under this path:
For example:
  • <prefix> is the prefix you set on the export. The default is lovable-export/.
  • Lovable shortens the workspace and export names in the path to lowercase letters and digits, with - between words, up to 48 characters.
  • Times in run= and window= are in UTC.
  • A window with no new data creates no file.
The files have the content type application/gzip. Any tool that reads gzipped JSON Lines can read them, such as Amazon Athena or BigQuery.

Prerequisites

  • An account with the destination provider, and permission to grant access there. Each destination page lists what you need.

Create a data export

These steps apply to every destination. Each destination page covers its own access setup.
1

Open Data exports

Go to Data exports (Workspace settings → Security → Data exports) and click New data export.
2

Name the export and choose a schedule

Enter a Name, for example Compliance audit log export. Keep the export Enabled. Under Schedule, choose Every 1 hour or Every 3 hours.
3

Choose the destination and the source

Under Destination, choose where to send the data and fill in its fields. Under Source, choose Audit logs.The setup panel next to the form shows the steps for your destination. It fills in the policies and commands with your values as you type. Follow the guide for your destination:
4

Test the connection

Click Test connection. Fix any error the test shows before you continue. See the troubleshooting section of your destination’s page.
5

Create the export

Click Create export. For Amazon S3, Lovable checks access again when you save. A failed check blocks the save.
The first run starts within a few minutes. Click the export in the list to watch it in Recent history.

How runs work

Schedule and timing

Each export runs on its schedule, every hour or every 3 hours. Each run exports the data that arrived since the previous run, up to about 5 minutes before the run started. An export runs one run at a time. If a run is still going when the next one is due, Lovable skips the scheduled run.

First run and history

The first run exports all the history that Lovable still holds for the source, then later runs continue with new data: The first run splits history into windows: up to 30 days each for audit logs. For object storage, each window becomes its own window= folder. If the first run fails partway, the next run starts the full history again from the same point and writes every window again under its own run= folder. Lovable removes the files the failed run wrote when it can.

Failed runs

When a run fails, Lovable does not move the export forward. The next run tries the same data again, so a failure does not leave a gap. The run shows a message that explains what to fix. See Troubleshooting.

Delivery and duplicates

Delivery is at least once. Lovable can deliver a row more than once, for example when it retries after a network error. Remove duplicates when you query the data: For object storage, a retry within a run overwrites the same file. A later run that delivers the same window again writes it under its own run= folder.

Monitor runs

The Data exports page lists your exports with their Last run, Activity, Next run, and Schedule. Click an export to open its details:
  • Destination: the destination address. Click to copy it.
  • Success, Rows, and Runs: totals for the period in the label, the last 7 days or the last runs loaded.
  • Run now: starts a run immediately.
  • Recent history: one row per run with its start time, duration, row count, and status. Runs you started with Run now show a Manual badge.
Click a run to expand it. You see the run ID, the rows, bytes, and files it wrote, and the time window it covered. For object storage, you also see each file with its size. Click the copy button to copy a file’s address.

Manage an export

Open the actions menu on an export row, or click the export to open its details.

Edit an export

Choose Edit export or Edit configuration. You can change the name, the schedule, and some destination settings, such as the prefix or a Splunk token. You cannot change the source or the destination itself, such as the bucket, the Splunk endpoint, or the Azure workspace. To change them, create a new export.

Pause and resume

Use the Schedule switch to pause or resume an export. A paused export does not run on its schedule, and Run now does not work until you resume it. When you resume, the next run starts within a few minutes and catches up on everything since the last successful run.

Run now

Choose Run now to start a run immediately. It exports the same new data that the next scheduled run would. You cannot start a run while another run of the same export is in progress.

Reset the watermark

The watermark marks how far an export has delivered. Choose Reset watermark to clear it. The next run exports the full history again, then continues with new data.
Resetting does not remove data you already received. Your destination will hold duplicate rows for the history that the next run sends again. Remove duplicates as described in Delivery and duplicates.
You cannot reset while a run is in progress.

Delete an export

Choose Delete export. Lovable stops the schedule and removes the run history for the export. Data that Lovable already delivered to your destination stays there. For Azure Log Analytics, the table and its data collection rule also stay.

Activity in your audit logs

Lovable records data export activity in your workspace audit logs: creating, editing, and deleting exports, manual runs, watermark resets, and connection tests.

Limitations

  • Each export has one source and one destination. Neither can change after you create the export.
  • The schedule is every hour or every 3 hours.
  • Data arrives at the destination at least 5 minutes after it happened, plus the time until the next run.
  • You cannot filter which events an export sends, for example by action or actor. Each export sends every audit log event in the workspace.

FAQ

Data exports are available on Enterprise plans. Workspace admins and owners can create and manage exports.
You do. The destination is in your own cloud or Splunk account, so your provider bills that account for storage, ingestion, and queries.
Only for Splunk, where Lovable stores your HTTP Event Collector token. For Amazon S3 and Azure Log Analytics, Lovable uses short-lived credentials that your cloud account trusts. You have no key to rotate.
Yes. Create one export per destination.
Delivery is at least once, so a retry can send a row again. A watermark reset also sends history again. Remove duplicates with id for object storage, lovable_event_id for Splunk, or EventId for Azure Log Analytics.
Lovable stops the schedule and removes the export’s run history. Everything already delivered stays in your destination. For Azure Log Analytics, the table, its rule, and its data stay in Azure.

Troubleshooting

The message names the problem, for example Could not assume the role or Authentication denied. Each destination page explains its messages and how to fix them:Destination configuration is invalid and Connection test failed mean a value in the form is wrong or the destination could not be reached. Check every field against the setup panel and test again.New permissions in AWS and Azure can take several minutes to apply. Wait, then test again.
Expand the run in Recent history to read its message. Fix the cause in your destination. The next scheduled run retries the same data, or you can click Run now.If the message says The export failed due to an internal error. Lovable has been notified., the problem is on the Lovable side. The next run retries automatically.
Lovable pauses an Amazon S3 export when its bucket no longer exists. This stops Lovable from writing to storage that someone else may now own. Fix the bucket, then resume the export with the Schedule switch.
No new data arrived for the source since the previous run. This is normal for a quiet workspace.
Run now needs the export to be enabled. Resume it with the Schedule switch first. If a run is already in progress, wait for it to finish.