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 ロールの例を表示するには、「追加のアクセス許可が必要なロギング [V2]」を参照してください。そのトピックには、CloudWatch Logs に送信されたログや Amazon S3 に送信されたログなど、さまざまなロギング先の例が含まれています。この例は、特定のロギング先リソースの更新を許可する方法を示しています。

Amazon Q in Connect のロギングを有効にする

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

  1. Amazon Q in Connect アシスタント (ドメイン とも呼ばれます) の ARN を取得します。アシスタントを作成したら、Amazon Connect コンソールから、または GetAssistant API を呼び出すことで、その ARN を取得できます。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 Logs、Amazon S3、または Amazon Data Firehose を選択できます。ログの保存先として、保存先オプション 1 つの ARN を指定する必要があります。ログの outputFormat は以下のいずれかを選択できます: json、plain、w3c、raw、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"