Journalisation et résolution des problèmes
Configuration de la diffusion des journaux
Amazon Q peut vous fournir des fichiers journaux qui vous aideront à comprendre et à résoudre les problèmes liés à votre personnalisation.
Vous pouvez envoyer vos fichiers journaux à un groupe Amazon CloudWatch Logs, à un compartiment Amazon S3, à un flux Amazon Data Firehose ou toute combinaison de ces solutions.
Pour configurer la diffusion des journaux, sélectionnez l’onglet Diffusion de journaux sur la page de la console de votre personnalisation. Suivez les instructions de l’interface pour configurer vos diffusions de journaux. Choisissez ensuite Créer des diffusions de journaux.
Le préfixe des journaux livrés à un compartiment Amazon S3 est : AWSLogs/ account_id/codeWhispererCustomizationLogs/region/customization_id/year/month/day/hour/
Les fichiers sont compressés et possèdent le format de dénomination suivant : account_id_codeWhispererCustomizationLogs_customization_id_date_file_id.log.gz
Avertissement
Afin de tirer le meilleur parti des journaux de personnalisation, il est préférable de configurer leur diffusion dans les cinq minutes suivant la création de la personnalisation.
Pour en savoir plus sur les autorisations requises pour transmettre des journaux à plusieurs ressources, consultez Journalisation nécessitant des autorisations supplémentaires [V2] dans le Guide de l’utilisateur Amazon CloudWatch Logs.
Explication des messages des journaux de personnalisation
Le tableau suivant répertorie les messages de journaux susceptibles de vous aider à comprendre les problèmes liés à votre personnalisation.
| Message du journal | Niveau de journalisation |
|---|---|
|
|
Infos |
|
|
Infos |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Infos |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Erreur |
|
|
Avertissement |
|
|
Erreur |
|
|
Erreur |
|
|
Infos |
Explication des messages d’erreur de la personnalisation dans la console
Le tableau suivant vous aide à comprendre les messages relatifs à la personnalisation de la console Amazon Q.
| Message d’erreur | Action suggérée |
|---|---|
|
Vous avez activé le nombre maximal de personnalisations. |
Désactivez une personnalisation active et réessayez. |
Vous avez dépassé le nombre maximal d’autorisations de groupe de |
Supprimez un groupe et réessayez. |
Vous avez dépassé le nombre maximal d’autorisations utilisateur de |
Supprimez un utilisateur et réessayez. |
Le nombre maximal de tâches actives a été atteint. |
Attendez la fin d’une tâche en cours sur le même compte. Réessayez. |
Une erreur inattendue s’est produite lors du traitement de la demande. |
Réessayez. Si l’erreur persiste, contactez le service client. |
Un problème est survenu lors de la récupération de certains des référentiels sélectionnés dans CodeConnections. Consultez les diffusions de journaux associées à la personnalisation pour plus d’informations. |
Essayez de créer ou de mettre à jour la personnalisation avec des référentiels valides auxquels votre connexion a accès. |
Accès refusé lors de la tentative d’accès à la connexion AWS CodeConnections fournie. |
Validez les autorisations de votre connexion et de votre fournisseur tiers. Réessayez ensuite. |
Un ou plusieurs référentiels sont introuvables lors de l’accès à la connexion AWS CodeConnections fournie. |
Validez les autorisations et la liste des référentiels du fournisseur tiers. Réessayez ensuite. |
L’ARN de la connexion AWS CodeConnections fournie n’est pas valide. |
Mettez à jour la personnalisation en corrigeant l’ARN de connexion. |
L’hôte associé à la connexion AWS CodeConnections fournie n’est pas disponible. |
Réessayez dans cinq minutes. |
Chemin d’accès Amazon S3 spécifié non valide. |
Mettez à jour la personnalisation avec un URI Amazon S3 valide. |
Impossible d’accéder au compartiment Amazon S3 fourni. |
Validez les autorisations pour le rôle de l’administrateur. Réessayez après avoir résolu les problèmes d’autorisation. |
Le compartiment Amazon S3 fourni n’existe pas. |
Mettez à jour la personnalisation avec un URI Amazon S3 valide. |
La clé Amazon S3 fournie n’existe pas. |
Mettez à jour la personnalisation avec un URI Amazon S3 valide. |
Données insuffisantes pour créer une personnalisation. Ajoutez d’autres fichiers dans les langages pris en charge et réessayez. |
Ajoutez des données supplémentaires à la même source de données et mettez à jour la personnalisation avec la même référence. |
La taille totale des référentiels fournis dépasse la taille |
Supprimez certaines données de la source de données fournie. Mettez à jour la personnalisation avec la même référence. |
Vous avez créé le nombre maximal de personnalisations. Supprimez une personnalisation et réessayez. |
Supprimez la personnalisation en cours et réessayez. |
Le compte comprend plusieurs personnalisations. Vous devez supprimer toutes les personnalisations avant de supprimer le profil. |
Supprimez toutes les personnalisations associées au compte et réessayez. |