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

受管知識庫的可觀測性

對於受管知識庫，Amazon Bedrock 會將操作指標和擷取日誌發佈到 AWS 您的帳戶，以便您可以監控知識庫的運作狀態和使用情況。執行時間指標可讓您追蹤知識庫 API 操作的請求量、錯誤和限流，而擷取日誌可讓您在資料擷取任務期間追蹤個別文件的狀態。下列各節說明可用的可觀測性資料，以及如何存取資料。

受管知識庫的執行期指標

Amazon Bedrock 會將知識庫 API 操作的執行時間指標發佈至 AWS/Bedrock/KnowledgeBases 命名空間下的 Amazon CloudWatch。使用這些指標來監控 等操作的調用量、錯誤率和限流Retrieve。指標會免費發佈至您的帳戶，並顯示在 CloudWatch 主控台中。

下表說明 Amazon Bedrock 為受管知識庫發佈的執行期指標。

ClientErrors只有在發生對應的條件時，才會發佈 ServerErrors、 和 Throttles指標。Invocations 指標會針對每個請求發佈。

AgenticRetrieveStream 操作的其他指標

除了上表中的指標之外， AgenticRetrieveStream操作還會發佈下列指標。

此指標使用值為 的Operation維度AgenticRetrieveStream。

受管知識庫指標的維度

Amazon Bedrock 將下列維度用於受管知識庫執行期指標。

發佈指標的許可

Amazon Bedrock 會使用與請求相關聯的登入資料，將這些指標發佈至您的帳戶：

若要發佈指標，必須允許該身分呼叫 cloudwatch:PutMetricData 做為AWS/Bedrock/KnowledgeBases命名空間。將授予此許可的政策連接到知識庫服務角色，以及呼叫知識庫操作的任何身分。下列範例會授予所需的許可。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "cloudwatch:PutMetricData",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "AWS/Bedrock/KnowledgeBases"
                }
            }
        }
    ]
}

指標發佈是最佳作法。如果身分沒有必要的許可，則不會發佈對應的指標，但知識庫請求本身不會受到影響。

檢視執行時間指標

您可以使用 AWS CLI AWS 管理主控台、 或 CloudWatch API 取得知識庫的指標。您可以透過其中一個 AWS 軟體開發套件 (SDKs) 或 CloudWatch API 工具來使用 CloudWatch API。

若要在 CloudWatch 主控台中檢視受管知識庫指標，請前往導覽窗格中的指標區段，然後選取所有指標選項，然後搜尋AWS/Bedrock/KnowledgeBases命名空間。

您必須擁有適當的 CloudWatch 許可，才能使用 CloudWatch 監控您的知識庫。如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的 Amazon CloudWatch 的身分驗證和存取控制。 Amazon CloudWatch

受管知識庫的儲存指標

對於受管知識庫，Amazon Bedrock 會在AWS/Bedrock/KnowledgeBases命名空間下將儲存指標發佈至 Amazon CloudWatch。此指標會報告存放在知識庫中的來源資料的總原始大小，並在資料擷取任務完成後發佈至您的帳戶，以便您可以追蹤一段時間內存放在知識庫中的資料量。

下表說明 Amazon Bedrock 為受管知識庫發佈的儲存指標。

儲存指標使用 KnowledgeBaseId維度，格式為 knowledge-base/knowledge-base-id。

受管知識庫的擷取可觀測性

Amazon Bedrock 會發出日誌，追蹤受管知識庫的資料擷取任務進度，包括整體任務狀態和處理的每個文件狀態。您可以使用這些日誌來確認擷取哪些文件、調查擷取結果中未傳回文件的原因，以及對擷取失敗進行疑難排解。

日誌會傳送到您設定的目的地 (CloudWatch Logs、Amazon S3 或 Amazon Data Firehose)。下列各節說明如何啟用日誌交付、擷取期間文件的生命週期、發出的日誌類型，以及範例查詢。

啟用擷取日誌交付

若要接收擷取日誌，請使用 AWS 管理主控台 或 CloudWatch API 為您的知識庫設定日誌交付。您可以將日誌交付至 CloudWatch Logs、Amazon S3 或 Amazon Data Firehose。

使用主控台啟用日誌交付

使用 CloudWatch API 啟用日誌交付

支援的日誌類型和許可

受管知識庫支援下列日誌類型：

若要啟用日誌交付，使用者或角色除了寫入所選目的地所需的bedrock:AllowVendedLogDeliveryForResource許可之外，還必須具有知識庫資源的許可。如需每個目的地的 IAM 政策範例，請參閱《Amazon CloudWatch Logs 使用者指南》中的不同交付目的地的已終止日誌許可。

擷取期間的文件生命週期

在資料擷取任務期間，每個文件會經過三個階段，而文件的日誌會記錄每個階段的狀態：

每個階段狀態為 SUCCESS或 FAILED。connector_document_status 欄位會報告文件的合併狀態，且只有在文件無法處理時才會填入error_message欄位。

日誌類型和範例

Amazon Bedrock 會針對受管知識庫擷取任務發出兩種類型的日誌項目，並以 event_type 欄位區分：

以下是任務層級狀態日誌的範例。

{
    "event_timestamp": 1718677300000,
    "event": {
        "ingestion_job_id": "<IngestionJobId>",
        "data_source_id": "<DataSourceId>",
        "knowledge_base_arn": "arn:aws:bedrock:<region>:<accountId>:knowledge-base/<KnowledgeBaseId>",
        "message": "Crawling started"
    },
    "event_version": "1.0",
    "event_type": "StartIngestionJob.StatusChanged",
    "level": "INFO"
}

以下是記錄單一文件處理狀態的文件層級日誌範例。

{
    "event_timestamp": 1718677342332,
    "event": {
        "ingestion_job_id": "<IngestionJobId>",
        "data_source_id": "<DataSourceId>",
        "knowledge_base_arn": "arn:aws:bedrock:<region>:<accountId>:knowledge-base/<KnowledgeBaseId>",
        "document_id": "<DocumentId>",
        "source_uri": "<SourceUri>",
        "content_type": "<ContentType>",
        "crawl_action": "ADD" | "DELETE" | "UNMODIFIED",
        "index_status": { "Status": "SUCCESS" | "FAILED", "UpdatedTime": "<epochMillis>" },
        "crawl_status": { "Status": "SUCCESS" | "FAILED", "UpdatedTime": "<epochMillis>" },
        "sync_status": { "Status": "SUCCESS" | "FAILED", "UpdatedTime": "<epochMillis>" },
        "chunk_statistics": {
            "created": int,
            "deleted": int,
            "failed_to_create": int,
            "failed_to_delete": int
        },
        "error_message": "<ErrorMessage>"
    },
    "event_version": "1.0",
    "event_type": "StartIngestionJob.ResourceStatusChanged",
    "level": "INFO" | "ERROR"
}

只有當文件無法處理時， error_message 欄位才會出現。chunk_statistics 欄位摘要說明為文件建立或刪除的區塊。

有些文件層級日誌會報告連接器狀態訊息，而不是上述顯示的狀態欄位。這些日誌包含具有人類可讀描述message的欄位 （例如，指出無法擷取或刪除文件的訊息），以及 INFO、 WARN或 level的 ERROR。

查詢範例

如果您將日誌交付至 CloudWatch Logs，您可以使用 CloudWatch Logs Insights 來查詢知識庫的擷取日誌。以下是一些常見的查詢。

受管知識庫的追蹤可觀測性

Amazon Bedrock 可以發出知識庫執行期操作的分散式追蹤 （跨度），以便您可以分析請求延遲和請求的內部步驟。追蹤只會針對 Retrieve操作發出，並傳送到 AWS X-Ray。追蹤交付使用與擷取日誌相同的付費日誌交付管道，其中包含TRACES日誌類型和 X-Ray 交付目的地。

使用 CloudWatch API 啟用追蹤交付

若要將追蹤交付至 AWS X-Ray，請依照下列步驟使用 CloudWatch API 建立交付。

追蹤交付的許可

若要啟用追蹤交付，除了交付至 AWS X-Ray 所需的bedrock:AllowVendedLogDeliveryForResource許可之外，使用者或角色還必須具有知識庫資源的許可。

檢視追蹤

啟用追蹤交付後，請呼叫 Retrieve操作來產生追蹤，然後在 AWS X-Ray 主控台中檢視它們。

受管知識庫的 AgentCore 可觀測性

Amazon Bedrock 將受管知識庫可觀測性資料與 Amazon Bedrock AgentCore 可觀測性體驗整合，讓您合併檢視知識庫指標和追蹤與其他 AgentCore 遙測。

此整合不需要額外的組態。如前幾節所述啟用執行時間指標和追蹤交付後，AgentCore 可觀測性頁面會自動填入對應的知識庫資料。無需採取額外的動作。

客戶支援和故障診斷

Amazon Bedrock 受管知識庫會暫時存放客戶查詢和相關聯的擷取資料，僅用於提供偵錯支援，以回應客戶報告的問題。除非客戶在支援參與期間明確同意，否則 AWS 不會存取此資料。Amazon Bedrock 不會使用此資料來訓練或改善基礎模型。