# AWS CloudTrail

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fintegrations%2Faws%2Faws-cloudtrail.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fintegrations%2Faws%2Faws-cloudtrail.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

Coralogix provides a predefined Lambda function to forward your CloudTrail logs straight to the Coralogix platform using our app in the [Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications/eu-central-1/597078901540/coralogix-aws-shipper).

## Requirements[​](#requirements "Direct link to Requirements")

* [Active trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html) in your AWS account enabled and sending data to your S3 bucket

* Permissions to create Lambda functions

## Setup[​](#setup "Direct link to Setup")

1. Log in to your AWS console.

2. Navigate to the [Coralogix AWS Shipper](https://serverlessrepo.aws.amazon.com/applications/eu-central-1/597078901540/coralogix-aws-shipper) application page.

3. Scroll to the bottom of the page and fill in the relevant fields.

**Note**! Ensure that the region in which the CloudFormation application is being run is **identical** to the region in which the CloudTrail S3 bucket exists.

4. Check the checkbox: `I acknowledge that this app creates custom IAM roles and resource policies`.

5. Click **Deploy**.

6. View your logs in your Coralogix dashboard.

## Parameters & Details[​](#parameters--details "Direct link to Parameters & Details")

Below is a table of references to the parameters you will see in the deployment screen.

| Parameter Name           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Application Name**     | Name of the Lambda function in your account                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **NotificationEmail**    | Failure notification email address<br />Requires a working SNS with a validated domain                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **S3BucketName**         | Name of the S3 bucket with CloudTrail logs to watch                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **ApplicationName**      | [**Application name**](https://docs-docusaurus.kinsta.page/user-guides/account-management/account-settings/application-and-subsystem-names/.md) as it appears in your Coralogix UI, i.e. `CloudTrail`                                                                                                                                                                                                                                                                                                                                                                                   |
| **CoralogixRegion**      | Region associated with your Coralogix account [**domain**](https://docs-docusaurus.kinsta.page/user-guides/account-management/account-settings/coralogix-domain/.md)<br />In case that you want to use a custom domain, leave this as default and input the `custom domain` in the CustomDomain field.                                                                                                                                                                                                                                                                                  |
| **CustomDomain**         | Coralogix custom domain<br />Leave empty if you do not use a custom domain.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **FunctionArchitecture** | Function supports x86\_64 or arm64                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **FunctionMemorySize**   | Max memory for the function itself<br />Default is 1024.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **FunctionTimeout**      | Maximum time in seconds the function may be allowed to run<br />Default is 300.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **ApiKey**               | Your Coralogix [](https://docs-docusaurus.kinsta.page/user-guides/account-management/api-keys/send-your-data-api-key/.md)**[Send-Your-Data API key](https://docs-docusaurus.kinsta.page/user-guides/account-management/api-keys/send-your-data-api-key/.md)**<br />If you have created a secret in **[AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)**, use the secret that contains your Coralogix [**Send-Your-Data API key**](https://docs-docusaurus.kinsta.page/user-guides/account-management/api-keys/send-your-data-api-key/.md). |
| **Layer\_ARN**           | If using **[AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)**, this is the ARN of the Coralogix [**Lambda layer**](https://serverlessrepo.aws.amazon.com/applications/eu-central-1/597078901540/Coralogix-Lambda-SSMLayer\)). If not, leave empty.                                                                                                                                                                                                                                                                                         |
| **CreateSecret**         | If you have created a secret in **[AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)** containing your Coralogix [**Send-Your-Data API key**](https://docs-docusaurus.kinsta.page/user-guides/account-management/api-keys/send-your-data-api-key/.md), set to False.                                                                                                                                                                                                                                                                         |
| **SubsystemName**        | [**Subsystem name**](https://docs-docusaurus.kinsta.page/user-guides/account-management/account-settings/application-and-subsystem-names/.md) as it appears in your Coralogix UI, i.e. AWS account ID                                                                                                                                                                                                                                                                                                                                                                                   |
| **S3KeyPrefix**          | Prefix of the path within the log that allows you choose whether part or all of the bucket is shipped                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **S3KeySuffix**          | S3 path suffix to watch<br />Default is `.json.gz`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

## Best Practices[​](#best-practices "Direct link to Best Practices")

Customers should add environment variable `CORALOGIX_BUFFER_SIZE` with value `268435456`.

## Additional Resources[​](#additional-resources "Direct link to Additional Resources")

|                        |                                                                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| External Documentation | [Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications/eu-central-1/597078901540/coralogix-aws-shipper) |
