Connect Your AWS Website to Agent & LLM Analytics

Overview

This integration uses an AWS Data Firehose endpoint to send analytics events to Dark Visitors from your AWS CloudFront distribution. Please contact us if you need help getting set up.

Step 1: Create a Data Firehose Stream

• Open your AWS dashboard
• In the search bar at the top of the screen, type in and select Amazon Data Firehose
• Click Create Firehose stream
• Select Direct PUT as a source, and HTTP endpoint as a destination
• Name the stream something like dark-visitors-analytics
• Enter this HTTP endpoint URL as the destination:

https://api.darkvisitors.com/logs/aws

• Navigate to the Dark Visitors Projects page and open your project
• Copy your access token from the Settings page
• Back in AWS, paste in your access token where it says Access key
• Select GZIP content encoding
• Under Backup settings, create a new bucket to record failed logs (this is required by AWS).
• Click Create Firehose stream

Step 2: Connect Your CloudFront Distribution

• Navigate back to your AWS dashboard and select your CloudFront distribution
• Select the Logging tab
• In the Access log destinations section, click the Add dropdown menu and select Amazon Kinesis Data Firehose
• Choose the stream you just created as the Destination stream
• Click Submit

Step 3: Test Your Integration

• Navigate to the Projects page
• Select your project
• Click Settings
• Click Send a Test Visit
• Click Realtime

If your website is correctly connected, you should see visits from the Dark Visitor agent in the realtime timeline within a few seconds.