# Security logs and alerts

Stream your account's activity logs to an Amazon S3 bucket you control.

> Security log streaming is available to approved accounts. To request access, email [security-product@stripe.com](mailto:security-product@stripe.com). After Stripe enables your account, configure a destination in the Dashboard.

Use activity logs to monitor your Stripe account, investigate security incidents, and maintain an audit trail with your existing tools.

Stripe delivers activity logs to your Amazon S3 bucket. If you use a security information and event management (SIEM) system, configure it to ingest the files from your bucket.

## What you can monitor

Activity logs record supported actions on your Stripe account, including:

- API key creation, updates, and deletion.
- User invitations and role changes.
- Authentication and access changes.
- Changes to account security settings.

For the supported actions, see [Tracked action types](https://docs.stripe.com/activity-logs.md#tracked-action-types). Activity logs record selected important events in your account. They aren’t a record of every API request to your account.

## How delivery works

A log destination connects your Stripe account to an S3 bucket and an optional path prefix. After you configure the destination, Stripe delivers activity logs as gzip-compressed JSONL files. JSONL contains one JSON object per line.

You control access to the delivered files, how your tools process them, and how long you retain them. Logs can contain user identifiers and IP addresses. Restrict access according to your organization’s security and privacy policies.

Your ingestion pipeline must handle duplicate records. Use each activity log’s ID to deduplicate records during ingestion.

## Log Destinations and the Activity Logs API

Use streaming for ongoing delivery to your storage. Use the [Activity Logs API](https://docs.stripe.com/activity-logs.md), available in public preview, to retrieve logs with API requests. You can use both methods.

Log Destination delivery requires you to create an S3 bucket and to configure your tools to read from that bucket. The Activity Logs API requires you to periodically or as necessary poll for new logs, manage pagination, and to store the returned logs.

## Preview scope

This preview delivers activity logs to Amazon S3. It doesn’t deliver API request logs or Stripe-generated security alerts.

Stripe starts delivering logs after you configure the destination and doesn’t backfill earlier logs.

## Get started

[Set up security log streaming](https://docs.stripe.com/security/logs-and-alerts/get-started.md) to connect your account to an S3 bucket.
