AWS S3 integration

Data forwarding

The AWS S3 integration lets you forward data to an S3 bucket further analysis. This lets you leverage HUMAN data alongside your existing logs and metrics within your AWS instance. You can use the AWS S3 integration to create a data export or trigger it with a data export action.

AWS S3 only supports sending Logs data.

Prerequisites

  • The S3 bucket access key ID and secret access key.
  • Appropriate role permissions to create and manage integrations

Integrate with AWS S3

  1. Navigate to Platform Settings > Integrations and click the AWS S3 integration.
  2. Click Add Integration.
  3. Provide the following:
    • Integration name: How the integration will appear in your HUMAN account.
    • Bucket: The name of the S3 bucket to send data to.
    • Region: The AWS region the bucket resides at.
    • SSE: Select a bucket encryption method.
    • Access Key ID: The S3 bucket access key ID.
    • Secret Access Key: The S3 bucket secret access key.
    • Path pattern: The file’s path. This does not affect the file name. See supported path patterns for details.
  4. Click Test Connection.
  5. Once the test succeeds, click Save changes.

You have successfully configured an AWS S3 integration. Make sure to use the integration to create a data export or trigger it with a data export action.

Supported path patterns

PatternPath ValueExample
{yyyy}Four digit year value2022
{mm}Two digit month value02
{dd}Two digit day16
{appId}Activity’s App IDPX12AB34CD

Path patterns allow the following characters:

  • a-z
  • A-Z
  • 0-9
  • -, /, !, \, _, ., \, *, ', ()

For example, for the date February 2, 2022, the path pattern would resolve to: 2022/02/16/production/PX12AB34CD.

File name patterns

File names generated by HUMAN follow the following pattern: {guid}_{appId}_{startTimestamp}_{endTimestamp}.

For example, for a file name of 7bd6079a-b5e4-4788-93c5-b939549ce5be_PX3tHq532g_1645014120000000000_1645014180000000000**, the values would be:

  • GUID: 7bd6079a-b5e4-4788-93c5-b939549ce5be
  • App ID: PX3tHq532g
  • Start timestamp (UNIX epoch): 1645014120000000000
  • End timestamp (UNIX epoch): 1645014180000000000