进阶 docs.writesonic.com 2026-10-09 08:02:29 · 0 阅读
第19章 集成CloudFront与AI Bot Analytics教程
集成 Cloudfront
本指南将带你一步步在 Cloudfront 网站上通过 AWS CloudFormation 堆栈部署 AI Bot Analytics。
前置条件
拥有有效的 Writesonic 账户
已有 AWS CloudFront 分配
AWS 账户需具备以下权限：
创建 CloudFormation 堆栈
修改 CloudFront 分配
创建 IAM 角色和策略
创建 S3 存储桶和 Kinesis 流
阶段一：在 Writesonic 中开始
前往 Writesonic 的 AI Bot Analytics 页面，选择 'Cloudfront' 作为提供商
点击 'Continue' 启动集成流程
Writesonic 会提供以下信息，后续 AWS 配置时会用到：
CloudFormation 模板文件
Writesonic API Key
阶段二：创建 CloudFormation 堆栈
步骤 1：进入 CloudFormation 服务
登录 AWS 管理控制台
进入 CloudFormation 服务
点击 "Create stack" 开始创建堆栈
步骤 2：上传模板 在 "Create stack" 页面，选择 "Upload a template file" 点击 "Choose file"，上传 Writesonic 提供的 CloudFormation 模板 点击 "Next" 继续
步骤 3：配置堆栈参数 填写以下堆栈参数： ParameterValueDescriptionDataStreamShardCount1Number of shards for the Kinesis Data StreamEnableEnhancedMonitoringFalseEnhanced monitoring settingS3BucketPrefixYour desired bucket namePrefix for the S3 bucket that will store logsWritesonicAPIKeyYour API keyAPI key provided by WritesonicWritesonicIngestionDomainingestion.writesonic.comWritesonic ingestion endpoint 填写完成后点击 "Next"。
步骤 4：配置堆栈选项 查看堆栈选项（无需额外配置） 点击 "Next" 继续
步骤 5：确认并创建 检查所有堆栈配置详情 勾选确认框，确认 CloudFormation 可能会创建 IAM 资源 点击 "Submit" 创建堆栈
步骤 6：等待堆栈创建完成 在 CloudFormation 控制台查看堆栈创建进度 等待状态变为 "CREATE_COMPLETE" 此过程通常需要几分钟 阶段三：配置 CloudFront 分配日志 步骤 1：进入 CloudFront 分配 在 AWS 控制台进入 CloudFront 服务 找到并选择要监控的 CloudFront 分配 点击 "Logging" 标签页
步骤 2：配置实时日志 在 Logging（日志）选项卡中，找到“实时日志”区域。 点击“编辑”以修改配置。
步骤 3：启用日志记录 将状态设置为“已启用”。 选择由 CloudFormation 堆栈创建的日志配置。 点击“保存更改”以应用该配置。
阶段 4：集成验证 完成所有步骤后，CloudFormation 堆栈的状态应显示为“CREATE_COMPLETE”。 你的 CloudFront 分发配置上的实时日志应处于“已启用”状态。 返回 Writesonic 中的 AI 机器人分析页面。 点击“验证集成”，确认你的 CloudFront 集成是否正常运行。 验证通过后，系统会将你重定向到分析仪表盘。该过程通常在 1–2 分钟内完成，最长可能需要 5 分钟。 故障排除 如果在设置过程中遇到任何问题： 堆栈创建失败：请检查你的 AWS 账户是否具备先决条件中列出的所有必要权限。 CloudFormation 错误：请核实所有参数是否输入正确，特别是 Writesonic API 密钥。 日志配置缺失：在配置 CloudFront 之前，请确保 CloudFormation 堆栈显示为“CREATE_COMPLETE”。 CloudFront 未记录日志：请确认实时日志已设置为“已启用”，且选择了正确的日志配置。 数据缺失：允许 5-10 分钟时间等待数据开始传输；同时检查你的网站是否正在接收流量。 API 密钥问题：请核实 Writesonic API 密钥是否已按原样复制，没有多余的空格。 如需帮助，请联系 [email protected] 重要说明 权限 请确保你的 AWS 账户拥有以下操作所需的必要权限： 创建 CloudFormation 堆栈 修改 CloudFront 分发配置 创建 IAM 角色和策略 创建 S3 存储桶和 Kinesis 流 成本考量 请注意以下相关的 AWS 费用： CloudFront 实时日志：按日志行数计费。 Kinesis 数据流：按分片小时数和 PUT 负载单位计费。 Kinesis Firehose：按传输到 Writesonic 端点的 GB 数计费。 S3 存储：按 GB/月计费（仅用于投递失败的后备存储，正常运行期间预计消耗极小）。 密钥管理器：按每月每个密钥计费。 详细定价请参阅 AWS 定价页面。请监控你的 AWS 账单仪表盘，以追踪集成成本。5个月前更新 本页对你有用吗？
步骤 2：上传模板 在 "Create stack" 页面，选择 "Upload a template file" 点击 "Choose file"，上传 Writesonic 提供的 CloudFormation 模板 点击 "Next" 继续
步骤 3：配置堆栈参数 填写以下堆栈参数： ParameterValueDescriptionDataStreamShardCount1Number of shards for the Kinesis Data StreamEnableEnhancedMonitoringFalseEnhanced monitoring settingS3BucketPrefixYour desired bucket namePrefix for the S3 bucket that will store logsWritesonicAPIKeyYour API keyAPI key provided by WritesonicWritesonicIngestionDomainingestion.writesonic.comWritesonic ingestion endpoint 填写完成后点击 "Next"。
步骤 4：配置堆栈选项 查看堆栈选项（无需额外配置） 点击 "Next" 继续
步骤 5：确认并创建 检查所有堆栈配置详情 勾选确认框，确认 CloudFormation 可能会创建 IAM 资源 点击 "Submit" 创建堆栈
步骤 6：等待堆栈创建完成 在 CloudFormation 控制台查看堆栈创建进度 等待状态变为 "CREATE_COMPLETE" 此过程通常需要几分钟 阶段三：配置 CloudFront 分配日志 步骤 1：进入 CloudFront 分配 在 AWS 控制台进入 CloudFront 服务 找到并选择要监控的 CloudFront 分配 点击 "Logging" 标签页
步骤 2：配置实时日志 在 Logging（日志）选项卡中，找到“实时日志”区域。 点击“编辑”以修改配置。
步骤 3：启用日志记录 将状态设置为“已启用”。 选择由 CloudFormation 堆栈创建的日志配置。 点击“保存更改”以应用该配置。
阶段 4：集成验证 完成所有步骤后，CloudFormation 堆栈的状态应显示为“CREATE_COMPLETE”。 你的 CloudFront 分发配置上的实时日志应处于“已启用”状态。 返回 Writesonic 中的 AI 机器人分析页面。 点击“验证集成”，确认你的 CloudFront 集成是否正常运行。 验证通过后，系统会将你重定向到分析仪表盘。该过程通常在 1–2 分钟内完成，最长可能需要 5 分钟。 故障排除 如果在设置过程中遇到任何问题： 堆栈创建失败：请检查你的 AWS 账户是否具备先决条件中列出的所有必要权限。 CloudFormation 错误：请核实所有参数是否输入正确，特别是 Writesonic API 密钥。 日志配置缺失：在配置 CloudFront 之前，请确保 CloudFormation 堆栈显示为“CREATE_COMPLETE”。 CloudFront 未记录日志：请确认实时日志已设置为“已启用”，且选择了正确的日志配置。 数据缺失：允许 5-10 分钟时间等待数据开始传输；同时检查你的网站是否正在接收流量。 API 密钥问题：请核实 Writesonic API 密钥是否已按原样复制，没有多余的空格。 如需帮助，请联系 [email protected] 重要说明 权限 请确保你的 AWS 账户拥有以下操作所需的必要权限： 创建 CloudFormation 堆栈 修改 CloudFront 分发配置 创建 IAM 角色和策略 创建 S3 存储桶和 Kinesis 流 成本考量 请注意以下相关的 AWS 费用： CloudFront 实时日志：按日志行数计费。 Kinesis 数据流：按分片小时数和 PUT 负载单位计费。 Kinesis Firehose：按传输到 Writesonic 端点的 GB 数计费。 S3 存储：按 GB/月计费（仅用于投递失败的后备存储，正常运行期间预计消耗极小）。 密钥管理器：按每月每个密钥计费。 详细定价请参阅 AWS 定价页面。请监控你的 AWS 账单仪表盘，以追踪集成成本。5个月前更新 本页对你有用吗？
