Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Surveillance de l'utilisation d'Amazon Quick à l'aide CloudWatch des journaux

Vous pouvez utiliser Amazon CloudWatch Logs pour diffuser des conversations par chat, des commentaires d'utilisateurs et des agent/research heures d'utilisation dans Amazon Quick afin que vous puissiez les analyser. Ces journaux peuvent être envoyés vers plusieurs destinations CloudWatch, telles qu'Amazon S3 ou Amazon Data Firehose (les tarifs standard s'appliquent). Nous vous recommandons de configurer les journaux automatiques peu de temps après avoir activé les fonctionnalités Amazon Quick AI.

Voici des exemples de tâches que vous pouvez effectuer avec les journaux d'Amazon Quick :

Destinations de journal prises en charge

Amazon Quick peut envoyer des journaux vers les destinations suivantes :

Conditions préalables

Avant de pouvoir activer la journalisation, assurez-vous d'avoir :

Configurer la journalisation

Pour activer la journalisation pour le chat et les commentaires Amazon Quick, vous devez configurer les autorisations IAM, créer une source et une destination de diffusion, et vérifier que les journaux sont correctement envoyés.

Définir des autorisations IAM

Pour configurer CloudWatch Logs pour Amazon Quick, utilisez les exemples de politique IAM suivants pour accorder les autorisations nécessaires.

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [{
        "Sid": "QuicksightLogDeliveryPermissions",
        "Effect": "Allow",
        "Action": "quicksight:AllowVendedLogDeliveryForResource",
        "Resource": "arn:aws:quicksight:region:account-id:account/account-id"
    }]
}

Vous devez également autoriser le principal du delivery.logs.amazonaws.com service dans votre politique de AWS KMS clés gérées par le client.

{
    "Effect": "Allow"		 	 	 ,
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*"
        }
    }
}

Configuration de l'abonnement au journal

Par exemple, des politiques IAM avec toutes les autorisations requises pour votre destination de journalisation spécifique, consultez la section Activer la journalisation à partir AWS des services dans le guide de l'utilisateur Amazon CloudWatch Logs.

Créez une source de diffusion à l'aide de l'opération PutDeliverySource CloudWatch Logs API. Donnez un nom à la source de livraison et pour resourceArn, spécifiez l’ARN de votre application. PourlogType, spécifiez CHAT_LOGS AGENT_HOURS_LOGS ou FEEDBACK_LOGS

{
    "logType": "CHAT_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}

{
    "logType": "FEEDBACK_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}

{
    "logType": "AGENT_HOURS_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}

Pour activer la journalisation des conversations des utilisateurs à l'aide des opérations de l'API CloudWatch Logs, vous devez appeler les opérations PutDeliverySourcePutDeliveryDestination, et de CreateDelivery l'API.

Vérifier la livraison du journal

Une fois configuré, vérifiez que les journaux sont livrés à votre destination :

Schéma et format du journal

Les journaux Amazon Quick suivent un schéma structuré avec des champs communs partagés entre tous les types de journaux et des champs spécifiques pour les journaux de discussion et de commentaires.

Champs communs

Tous les événements du journal incluent les champs communs suivants :

Journaux de discussion

Les journaux de discussion enregistrent les interactions de conversation et contiennent les champs ci-dessous :

Voici un exemple de journaux de discussion :

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "latency": "10000", 
    "time_to_first_token": "10000",
    "message_scope": "all_resources",
    "user_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message": "Hi chat",
    "agent_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "flow_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?",
    "system_text_message": "Hello user",
    "surface_type": "WEB_EXPERIENCE",
    "web_search": "true"
    "user_selected_resources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}],
    "action_connectors": [{"action_connector_id": "quicksight-website"},{"action_connector_id": "123abs-1234-534894"}]
    "cited_resource": [{"cited_resource_name": "Dashboard","cited_resource_id": "146abs-1222-534894","cited_resource_name": "ds1"},{"cited_resource_name": "Space","cited_resource_id": "123abs-1234-534894","cited_resource_name": "space1"}],
    "file_attachment": [{"file_attachmet_type": "pdf","file_attachment_name": "file1.pdf"},{"file_attachmet_type": "txt","file_attachment_name": "file2.txt"}]
}

Journaux de commentaires

Les journaux de commentaires enregistrent les commentaires des utilisateurs sur le chat et contiennent les champs ci-dessous :

Voici un exemple de journaux de commentaires :

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message_id" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "feedback_type" :"Not Useful / Useful"
    "feedback_reason" : "Too wordy,Issue with sources,Other etc."
    "feedback_details" : "additional text shared by user"
}

Journaux des heures de l'agent/de la recherche

Ce type de journal capture les journaux d'utilisation des différents agents de votre compte Quick utilisés pour la tarification :

Voici un exemple de journal des heures d'utilisation des agents :

{
    "subscription_type": "ENTERPRISE",
    "reporting_service": "RESEARCH",
    "usage_group": "Included",
    "usage_hours": 0.3333,
    "service_resource_arn": "arn:aws:quicksight:eu-west-1:111222333444:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d"
}

Considérations sur la sécurité