CloudWatch Logs を使用して Amazon Q in Connect をモニタリングする - Amazon Connect
必要なIAMアクセス許可 ログ記録の有効化サポートされているログタイプ CloudWatch Logs クォータを確認するアシスタントログの例アシスタントログをデバッグするための一般的なクエリの例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CloudWatch Logs を使用して Amazon Q in Connect をモニタリングする

Amazon Q in Connect がエージェントに提供するリアルタイムのレコメンデーションと、自然言語を理解して検出する顧客の意図を把握するために、 CloudWatch Logs. CloudWatch Logs にクエリを実行すると、会話、トリガー、インテント、レコメンデーションなど、問い合わせジャーニー全体を把握できます。また、この情報をデバッグに使用したり、問い合わせ AWS Support 時に に提供したりすることもできます。

このトピックでは、Amazon Q in Connect のログ記録を有効にする方法について説明します。

必要なIAMアクセス許可

Amazon Q in Connect アシスタントのログ記録を有効にする前に、次の AWS Identity and Access Management アクセス許可があることを確認してください。Amazon Connect コンソールにサインインしているユーザーアカウントに必要です。

  • wisdom:AllowVendedLogDeliveryForResource: アシスタントリソースのログの配信を許可するために必要です。

特定のログ記録先に必要なすべてのアクセス許可を持つIAMロールの例を表示するには、「追加のアクセス許可を必要とするログ記録」を参照してください。このトピックには、 CloudWatch ログに送信されたログや Amazon S3 に送信されたログなど、さまざまなログ記録先の例が含まれています。この例は、特定のログ記録先リソースの更新を許可する方法を示しています。

Amazon Q in Connect のログ記録を有効にする

Amazon Q in Connect のログ記録を有効にするには、 を使用します CloudWatch API。以下の手順を実行します。

  1. Amazon Q in Connect アシスタント (ドメイン とも呼ばれます) ARNの を取得します。アシスタント を作成したら、Amazon Connect コンソールARNから、または GetAssistant を呼び出すことで、そのアシスタント を取得できますAPI。ARN 次の形式です。

    arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

  2. を呼び出すPutDeliverySource: これ CloudWatch APIを使用して、アシスタントの配信ソースを作成します。アシスタントARNの を として渡しますresourceArn。ではlogType、 を指定EVENT_LOGSしてアシスタントからログを収集します。

    {
    "logType": "EVENT_LOGS",
    "name": "your-assistant-delivery-source",
    "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
}

  3. を呼び出すPutDeliveryDestination: これ CloudWatch APIを使用して、ログの保存先を設定します。ログの保存先として、 CloudWatch ログ、Amazon S3、または Amazon Data Firehose を選択できます。ログを保存する送信先オプションの 1 ARNつを指定する必要があります。ログoutputFormatの を、、json、、plainw3craw、 のいずれかに選択できますparquet。

    次の例は、Amazon CloudWatch Logs グループおよび JSON形式で保存されるログを設定する方法を示しています。

    {
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
    },
    "name": "string",
    "outputFormat": "json",
    "tags": {
        "key": "value"
    }
}

  4. を呼び出すCreateDelivery: これ CloudWatch APIを使用して、配信ソースを前のステップで作成した配信先にリンクします。このAPIオペレーションは、配信元を最終送信先と関連付けます。

    {
    "deliveryDestinationArn": "string",
    "deliverySourceName": "string",
    "tags": {
        "string": "string"
    }
}

サポートされているログタイプ

Amazon Q in Connect は、次のログタイプをサポートしています。

  • EVENT_LOGS: 通話とチャット中に Amazon Q in Connect アシスタントのイベントを追跡するログ。

CloudWatch Logs クォータを確認する

Amazon CloudWatch Logs エンドポイントとクォータをチェックして、 CloudWatch Logs 配信関連のAPI呼び出しを行うためのクォータがあるかどうかを確認することをお勧めします。クォータは、 を呼び出しAPIたり、リソースを作成したりできる最大回数を設定します。制限を超えるとServiceQuotaExceededExceptionエラーが発生します。

アシスタントログの例

イベントログの例を次に示します。イベントタイプによっては、より多くのフィールドが表示される場合があります。

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

イベントタイプによっては、より多くのフィールドが表示される場合があります。例えば、チャットまたは音声イベントには発話に関する情報があります。レコメンデーションを生成したイベントには、インテント、トリガー、またはレコメンデーション自体に関する情報があります。

アシスタントログをデバッグするための一般的なクエリの例

クエリを使用してログを操作できます。例えば、 を使用して、セッション内のすべてのイベントをクエリできますSESSION_NAME。

以下は、特定のセッション用に生成されたすべてのログを返すための 2 つの一般的なクエリです。

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"