本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 CloudWatch 記錄監控知識庫

Amazon 基岩支援監控系統，協助您了解知識庫中任何資料擷取任務的執行情況。以下各節說明如何使用這兩種方式啟用和設定 Amazon 基岩知識庫的記錄系統 AWS Management Console 和 CloudWatch API。您可以透過此記錄系統，瞭解知識庫資源的資料擷取。

使用主控台記錄知識庫

若要啟用 Amazon 基岩知識庫的記錄，請使用 AWS Management Console:

知識庫記錄使用 CloudWatch API

要使用以下命令啟用 Amazon 基岩知識庫的日誌記錄： CloudWatch API

支援的記錄類型

Amazon 基岩知識庫支援下列日誌類型：

使用者權限和限制

若要啟用 Amazon 基岩知識庫的記錄功能，登入主控台的使用者帳戶需要下列許可：

您也可以在記錄服務配額說明文件中，檢查是否有任何配額限制來進行CloudWatch 記 CloudWatch 錄傳送相關API呼叫。配額限制可設定您可呼叫API或建立資源的次數上限。如果超過限制，則會導致ServiceQuotaExceededException錯誤。

知識庫記錄的範例

有適用於 Amazon 基岩知識庫的資料擷取層級日誌和資源層級日誌。

以下是資料擷取工作記錄的範例。

{
    "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期間查詢具有事件狀態的所有文件。

下列是一些常見的查詢，可用來偵錯使用記錄檔深入解析所產生的 CloudWatch 記錄檔：