日志记录和故障排除 - Amazon Q 开发者版
设置日志传输了解 Amazon CloudWatch 日志了解控制台错误消息

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

日志记录和故障排除

设置日志传输

Amazon Q 可以为您提供日志文件，帮助您了解和解决自定义问题。

您可以将日志文件发送到 Amazon Log CloudWatch s. 组、Amaz on S3 存储桶、Amaz on Data Firehose 或任意组合。

要设置日志传输，请在控制台页面上选择日志传输选项卡进行自定义。按照界面中的说明配置日志传输。然后选择 “创建日志传送”。

传送到 Amazon S3 存储桶的日志的前缀将是：AWSLogs/account_id/codeWhispererCustomizationLogs/region/customization_id/year/month/day/hour/

文件将被压缩，命名格式为：account_id_codeWhispererCustomizationLogs_customization_id_date_file_id.log.gz

警告

为了充分利用自定义日志，最好在创建自定义项后的五分钟内设置日志传输。

要详细了解将日志传送到多个资源所需的权限，请参阅 Amazon Logs 用户指南中的需要额外权限的 CloudWatch 日志记录 [V2]。

了解与自定义相关的日志消息

下表列出了可能有助于您了解自定义问题的日志消息。

日志消息 日志级别

Starting to ingest number repos from source source

信息

Downloading data from repo: repo name

信息

Received amount MB of supported data. amount MB required. Add more data and retry.

错误

The provided CodeStar Connection ARN: Arn is invalid.

错误

Access denied when attempting to reach the provided CodeStar Connection: Arn

错误

Failed to download with AWS CodeStar Connection: Arn probably deleted by customer

错误

ProviderThrottlingException from CodeStar Connection: Arn while cloning repository: repository

错误

Processing data from S3: S3 URI

信息

Invalid S3 path specified: S3 Directory

错误

Unable to access the provided S3 bucket: bucket name

错误

The provided S3 bucket: bucket name does not exist.

错误

The provided S3 key S3 URI does not exist.

错误

Failed to ingest number of failed repos / total number of repos repositories

错误

Unable to process repository: repo name, with a size of repo size GB, exceeds the limit of max size GB.

警告

Unable to process file: file name, with a size of file size, which exceeds the limit of max file size MB

错误

Unable to process collection: collection name, with total size of total repo size MB, which exceeds the limit of max total repo size MB

错误

The following languages will be used for customization: list of languages. Languages may be excluded from customization if they are not sufficiently represented in your files.

信息

了解控制台中与自定义相关的错误消息

下表将帮助您理解 Amazon Q 控制台中与自定义相关的消息。

错误消息 建议采取的措施

您已激活最大数量的自定义。

停用已激活的自定义并重试。

您已超过群组权限的最大数量限制。

移除群组并重试。

您已超过用户权限限制的最大数量。

移除用户并重试。

已达到最大活跃任务数。

等到同一个账户中正在进行的任务完成。重试该操作。

处理请求时遇到意外错误。

重试该操作。如果仍然失败，请联系客户支持。

尝试访问提供的 AWS CodeConnections 连接时访问被拒绝。

验证您的连接和第三方提供商的权限。然后重试该操作。

访问提供的 AWS CodeConnections 连接时未找到一个或多个存储库。

验证第三方提供商提供的权限和存储库列表。然后重试该操作。

提供的 AWS CodeConnections 连接 ARN 无效。

使用更正后的连接 ARN 更新自定义。

与所提供的 AWS CodeConnections 连接关联的主机不可用。

5 分钟后再试一次。

指定的 Amazon S3 路径无效。

使用有效的 Amazon S3 URI 更新自定义设置。

无法访问提供的 Amazon S3 存储桶。

验证管理员角色的权限。修复所有权限问题后重试。

提供的 Amazon S3 存储桶不存在。

使用有效的 Amazon S3 URI 更新自定义设置。

提供的亚马逊 S3 密钥不存在。

使用有效的 Amazon S3 URI 更新自定义设置。

数据不足，无法创建自定义项。从支持的语言中添加更多文件，然后重试。

向同一个数据源添加更多数据，并使用相同的参考更新自定义项。

提供的存储库的总大小超过了自定义允许的最大大小。

从提供的数据源中移除一些数据。使用相同的参考更新自定义。

您创建的自定义项已达到最大数量。请删除现有的自定义项并重试。

删除当前的自定义并重试。

账户中存在自定义设置。在删除配置文件之前，必须先删除所有自定义设置。

删除与该账户关联的所有自定义设置，然后重试。