Amazon Q Business - 監控

---

---

監控對於確保 Amazon Q Business 和其他 AWS 解決方案的可靠性、可用性和效能至關重要。AWS 提供以下監控工具來跟蹤 Amazon Q Business，檢測問題並在需要時觸發自動操作。

• AWS CloudTrail 跟蹤並記錄在您的 AWS 賬戶中進行的所有 API 呼叫和相關事件，並將日誌儲存在指定的 Amazon S3 儲存桶中。這使您可以識別進行呼叫的使用者和賬戶、其源 IP 地址以及呼叫的時間戳。
• Amazon CloudWatch 即時監控您的 AWS 資源和應用程式。它幫助您收集和跟蹤指標、建立自定義儀表板並設定警報，以便在指標達到設定閾值時提醒您或採取措施。例如，它可以跟蹤您的 Amazon EC2 例項的 CPU 使用率，並在需要時自動啟動新的例項。
• Amazon CloudWatch Logs 幫助您監控、儲存和訪問來自各種來源（如 Amazon EC2 例項和 CloudTrail）的日誌檔案。它可以跟蹤這些日誌中的資訊，並在滿足某些閾值時提醒您，還可以將您的日誌資料存檔到安全且持久的儲存中。

使用 AWS CloudTrail 記錄 API 呼叫

Amazon Q Business 日誌記錄 使用 AWS CloudTrail 記錄 Amazon Q Business API 呼叫會捕獲 Amazon Q Business 的所有 API 呼叫作為事件。捕獲的呼叫包括來自 Amazon Q 控制檯的呼叫以及對 Amazon Q API 的程式碼呼叫。這使您可以跟蹤由或代表您的 AWS 賬戶進行的 API 呼叫。

跟蹤是一種配置，它使您可以將事件作為日誌檔案傳遞到您指定的 Amazon S3 儲存桶。CloudTrail 日誌檔案包含一個或多個日誌條目。事件表示來自任何來源的單個請求，幷包含有關請求的操作、操作的日期和時間、請求引數等資訊。

以下是一個 CloudTrail 日誌條目的示例，它演示了 CreateApplication 操作

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "principal ID",
        "arn": "ARN",
        "accountId": "account ID",
        "accessKeyId": "access key ID",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "principal ID",
                "arn": "ARN",
                "accountId": "account ID",
                "userName": "user name"
            },
            "webIdFederationData": {},
            "attributes": {
                "creationDate": "yyyy-mm-ddThh:mm:ssZ",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "yyyy-mm-ddThh:mm:ssZ",
    "eventSource": "qbusiness.amazonaws.com",
    "eventName": "CreateApplication",
    "awsRegion": "region",
    "sourceIPAddress": "region",
    "userAgent": "user agent",
    "requestParameters": {
        "name": "name",
        "roleArn": "description",
        "clientToken": "client token"
    },
    "responseElements": {
        "applicationId": "application ID"
    },
    "requestID": "request ID",
    "eventID": "event ID",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "account ID",
    "eventCategory": "Management",
    "tlsDetails": {
        "tlsVersion": "TLS version",
        "cipherSuite":  "cipher suite",
        "clientProvidedHostHeader": "qbusiness.us-west-2.api.aws"
    }
}

使用 AWS CloudTrail 記錄 Apps API 呼叫

Amazon Q Apps 與 AWS CloudTrail 整合，AWS CloudTrail 是一種記錄使用者、角色或 AWS 服務執行的操作的服務。CloudTrail 將對 Amazon Q Apps 的所有 API 呼叫捕獲為事件，包括來自 Web 體驗、控制檯以及對 API 操作的程式碼呼叫的呼叫。

瞭解 Amazon Q Apps 日誌檔案條目

跟蹤是一種設定，它將事件日誌傳送到您選擇的 Amazon S3 儲存桶。這些日誌檔案包含一個或多個日誌條目，每個條目代表一個包含操作、日期、時間和請求引數等詳細資訊的單個請求。請注意，這些日誌檔案不會按特定順序顯示 API 呼叫，而是作為單獨的事件顯示。

以下示例顯示了一個 CloudTrail 日誌條目，它演示了 GetLibraryItem 操作。

{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "principal ID",
        "arn": "ARN",
        "accountId": "account ID",
        "accessKeyId": "access key ID",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "principal ID",
                "arn": "ARN",
                "accountId": "account ID",
                "userName": "user name"
            },
            "attributes": {
                "creationDate": "yyyy-mm-ddThh:mm:ssZ",
                "mfaAuthenticated": "false"
            }
        },
        "onBehalfOf": {
            "userId": "user ID",
            "identityStoreArn": "ARN"
        }
    },
    "eventTime": "yyyy-mm-ddThh:mm:ssZ",
    "eventSource": "qapps.amazonaws.com",
    "eventName": "GetLibraryItem",
    "awsRegion": "region",
    "sourceIPAddress": "source IP address",
    "userAgent": "user agent",
    "requestParameters": {
        "input": "query input",
        "idc-application-arn": "ARN",
        "application-id": "Q application ID"
    },
    "requestID": "request ID",
    "eventID": "event ID",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "account ID",
    "eventCategory": "Management"
}

使用 Amazon CloudWatch 進行監控

您可以使用 Amazon CloudWatch 監控 Amazon Q Business，Amazon CloudWatch 會收集資料並將其近乎即時地轉換為易於閱讀的指標。這些指標儲存 15 個月，使您可以訪問歷史資料並瞭解您的 Web 應用程式或服務隨時間的效能。您還可以設定警報以監視特定閾值，並在滿足這些閾值時接收通知或採取措施。

使用 CloudWatch 指標

要使用指標，您必須指定以下資訊

• 名稱空間是 CloudWatch 中 Amazon Q 釋出其指標的容器。要使用 CloudWatch ListMetrics API 或 list-metrics 命令檢視 Amazon Q Business 指標，請使用名稱空間“AWS/QBusiness”。
• 指標維度是用於識別指標的名稱-值對。例如，“ApplicationId”可以是維度名稱。您不必指定指標維度，它是可選的。
• 指標名稱。例如，DocumentsIndexed。

下表顯示了指標的一些常見用途。這些只是建議，可以幫助您入門，而不是完整的列表。

檢視 Amazon Q Business 指標

以下步驟演示瞭如何使用 CloudWatch 控制檯訪問 Amazon Q Business 指標。

• 開啟 CloudWatch 控制檯
• 選擇指標，選擇所有指標選項卡，然後選擇 AWS/QBusiness。
• 選擇指標維度。
• 從列表中選擇所需的指標，併為圖表選擇一個時間段。

Amazon Q Business 聊天指標

下表顯示了 Amazon Q Business 即時傳送到 CloudWatch 的聊天和對話管理指標。

Amazon Q Business 索引指標

下表顯示了 Amazon Q Business 即時傳送到 CloudWatch 的索引指標。