Integrating with Cloudfront

Prerequisites

• An active Writesonic account
• An existing AWS CloudFront distribution
• AWS Account with permissions to:
  • Create CloudFormation stacks
  • Modify CloudFront distributions
  • Create IAM roles and policies
  • Create S3 buckets and Kinesis streams

Phase 1: Start in Writesonic

1. Head over to the AI Bot Analytics page on Writesonic and choose 'Cloudfront' as a provider
2. Click on 'Continue' to initialize the integration
3. Writesonic will provide you the following information that you'll need during the AWS configuration:
   • CloudFormation Template File
   • Writesonic API Key

Phase 2: Create CloudFormation Stack

Step 1: Access CloudFormation Service

1. Log in to your AWS Management Console
2. Navigate to the CloudFormation service
3. Click on "Create stack" to begin the stack creation process

Step 2: Upload Template

1. On the "Create stack" page, select "Upload a template file"
2. Click "Choose file" and upload the CloudFormation template provided by Writesonic
3. Click "Next" to proceed

Step 3: Configure Stack Details

1. Specify the following stack parameters:

2. Click "Next" after entering all parameters.

Step 4: Configure Stack Options

1. Review the stack options (no additional configuration required)
2. Click "Next" to continue

Step 5: Review and Create

1. Review all stack configuration details
2. Check the acknowledgment box confirming that CloudFormation might create IAM resources
3. Click "Submit" to create the stack

Step 6: Wait for Stack Creation

1. Monitor the stack creation progress in the CloudFormation console
2. Wait for the status to change to "CREATE_COMPLETE"
3. This process typically takes several minutes

Phase 3: Configure CloudFront Distribution Logging

Step 1: Access CloudFront Distribution

1. Navigate to the CloudFront service in AWS Console
2. Locate and select the CloudFront distribution you want to monitor
3. Click on the "Logging" tab

Step 2: Configure Real-time Logs

1. In the Logging tab, locate the "Real-time logs" section
2. Click on "Edit"" to modify the configuration

Step 3: Enable Logging

1. Set the Status to "Enabled"
2. Select the Log configuration that was created by the CloudFormation stack
3. Click "Save changes" to apply the configuration

Phase 4: Integration Verification

1. After completing all the steps, the CloudFormation stack should show as "CREATE_COMPLETE"
2. Real-time logs should be "Enabled" on your CloudFront distribution
3. Return to AI Bot Analytics Page in Writesonic
4. Click on "Verify Integration" to confirm that your Cloudfront integration is working properly
5. Once verified, you'll be redirected to your analytics dashboard. The process typically finishes in 1–2 minutes but may take up to 5 minutes.

Troubleshooting

If you encounter any issues during setup:

• Stack Creation Fails: Check that your AWS account has all required permissions listed in Prerequisites
• CloudFormation Errors: Verify that all parameters are entered correctly, especially the Writesonic API Key
• Missing Log Configuration: Ensure the CloudFormation stack shows "CREATE_COMPLETE" before configuring CloudFront
• CloudFront Not Logging: Confirm that real-time logs are set to "Enabled" and the correct log configuration is selected
• Missing Data: Allow 5-10 minutes for data to begin flowing; check that your website is receiving traffic
• API Key Issues: Verify the Writesonic API Key is copied exactly as provided without extra spaces

For assistance, contact [email protected]

Important Notes

Permissions

Ensure that your AWS account has necessary permissions for:

• Creating CloudFormation stacks
• Modifying CloudFront distributions
• Creating IAM roles and policies
• Creating S3 buckets and Kinesis streams

Cost Considerations

Be aware of AWS costs associated with:

• Kinesis Data Streams (based on shard hours and PUT payload units)
• S3 storage for log data
• CloudFront real-time logs (per log line)

Monitor your AWS billing dashboard to track integration costs.