使用 CloudWatch 日志监控知识库

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

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

Amazon Bedrock 支持使用监控系统来帮助您了解知识库中任意数据摄取作业的执行情况。以下各节介绍如何同时使用和 CloudWatch API 为 Amazon Bedrock 知识库启用 AWS Management Console 和配置日志系统。您可以利用此日志记录系统了解知识库资源的数据摄取情况。

使用控制台进行知识库日志记录

使用 AWS Management Console为 Amazon Bedrock 知识库启用日志记录：

知识库使用 CloudWatch API 进行日志记录

要使用 CloudWatch API 启用 Amazon Bedrock 知识库的日志记录，请执行以下操作：

支持的日志类型

Amazon Bedrock 知识库支持以下日志类型：

用户权限和限制

要为 Amazon Bedrock 知识库启用日志记录，登录控制台的用户账户需要具有以下权限：

您还可以在日志服务配额文档中查看进行与 CloudWatch 日志传送相关的 API 调用是否有任何配额限制。CloudWatch 配额限制设置了您可以调用 API 或创建资源的最大次数。如果超出限制，则会导致 ServiceQuotaExceededException 错误。

知识库日志示例

Amazon Bedrock 知识库有数据摄取级别日志和资源级别日志。

下面是数据摄取作业日志的一个示例。

{
    "event_timestamp": 1718683433639,
    "event": {
        "ingestion_job_id": "<IngestionJobId>",
        "data_source_id": "<IngestionJobId>",
        "ingestion_job_status": "INGESTION_JOB_STARTED" | "COMPLETE" | "FAILED" | "CRAWLING_COMPLETED"
        "knowledge_base_arn": "arn:aws:bedrock:<region>:<accountId>:knowledge-base/<KnowledgeBaseId>",
        "resource_statistics": {
            "number_of_resources_updated": int,
            "number_of_resources_ingested": int,
            "number_of_resources_scheduled_for_update": int,
            "number_of_resources_scheduled_for_ingestion": int,
            "number_of_resources_scheduled_for_metadata_update": int,
            "number_of_resources_deleted": int,
            "number_of_resources_with_metadata_updated": int,
            "number_of_resources_failed": int,
            "number_of_resources_scheduled_for_deletion": int
        }
    },
    "event_version": "1.0",
    "event_type": "StartIngestionJob.StatusChanged",
    "level": "INFO"
}

下面是资源级别日志的一个示例。

{
    "event_timestamp": 1718677342332,
    "event": {
        "ingestion_job_id": "<IngestionJobId>",
        "data_source_id": "<IngestionJobId>",
        "knowledge_base_arn": "arn:aws:bedrock:<region>:<accountId>:knowledge-base/<KnowledgeBaseId>",
        "document_location": {
            "type": "S3",
            "s3_location": {
                "uri": "s3:/<BucketName>/<ObjectKey>"
            }
        },
        "status": "<ResourceStatus>"
        "status_reasons": String[],
        "chunk_statistics": {
            "ignored": int,
            "created": int,
            "deleted": int,
            "metadata_updated": int,
            "failed_to_create": int,
            "failed_to_delete": int,
            "failed_to_update_metadata": int  
        },
    },
    "event_version": "1.0",
    "event_type": "StartIngestionJob.ResourceStatusChanged",
    "level": "INFO" | "WARN" | "ERROR"
}

资源的 status 可以是以下项之一：

用于调试知识库日志的常见查询示例

您可以使用查询与日志进行交互。例如，您可以在摄取文档或数据时查询事件状态为 RESOURCE_IGNORED 的所有文档。

以下是一些可用于调试使用 Logs Insights 生成的 CloudWatch 日志的常见查询：