Résoudre les problèmes liés à un sujet d'importation Amazon Managed Streaming for Apache Kafka

Ce document fournit quelques conseils de dépannage courants pour les sujets d'importation Amazon Managed Streaming for Apache Kafka (Amazon MSK).

Une fois que vous avez configuré le sujet d'importation et commencé à ingérer des messages, vous pouvez vérifier les métriques Cloud Monitoring pertinentes pour voir si les données sont ingérées. Procédez comme suit :

1. Dans la console, accédez à la page Sujets.

   Accéder aux sujets

2. Cliquez sur le sujet d'importation Amazon MSK que vous souhaitez dépanner.

3. Sur la page d'informations du sujet, cliquez sur l'onglet Métriques.

4. Consultez le graphique de la métrique Nombre d'octets ingérés.

5. Si aucune donnée n'est ingérée, vérifiez si le champ État du thème contient une erreur sur la page d'informations du thème.

6. Vous pouvez également consulter la métrique État de la source de données d'ingestion. Pour ce faire, sur la page d'informations du thème, cliquez sur l'onglet Métriques.

7. Voici une liste des erreurs que vous pouvez rencontrer :

   Code d'erreur	Description	Corriger
   MSK_PERMISSION_DENIED	Erreur lors de l'utilisation des données Amazon MSK en raison de problèmes d'autorisation.	Vérifiez que l'ARN du rôle AWS est exact et que le rôle AWS dispose des autorisations de lecture requises. Pour en savoir plus, consultez Créer une règle dans AWS.
   		Assurez-vous qu'un compte de service existe et qu'il est correctement configuré, comme décrit dans la procédure Créer un rôle dans AWS à l'aide d'une stratégie d'approbation personnalisée. Pour en savoir plus sur la création d'un compte de service, consultez Créer un compte de service dans Google Cloud.
   		Vérifiez que le compte de service Pub/Sub dispose de l'autorisation iam.serviceAccounts.getOpenIdToken. Pour en savoir plus, consultez Ajouter le rôle "Créateur de jetons du compte de service" au compte de service Pub/Sub.
   		Vérifiez que vous avez ajouté le rôle "Utilisateur du compte de service" au compte de service. Pour en savoir plus, consultez Ajouter le rôle Utilisateur du compte de service au compte de service.
   PUBLISH_PERMISSION_DENIED	Erreur lors de la publication dans le sujet Pub/Sub en raison de problèmes d'autorisation.	Accordez au compte de service Pub/Sub les autorisations de publication nécessaires. Pour en savoir plus, consultez Ajouter le rôle d'éditeur Pub/Sub au compte de service Pub/Sub.
   CLUSTER_NOT_FOUND	Le cluster fourni est introuvable.	Vérifiez l'exactitude de l'ARN du cluster. Assurez-vous que le cluster existe et qu'il est accessible.
   Cluster is not public	Impossible d'accéder au cluster fourni	Les clusters non publics derrière des VPC ne sont pas compatibles. Vous devez utiliser un cluster public.
   TOPIC_NOT_FOUND	Le sujet Kafka fourni est introuvable.	Vérifiez que le nom du sujet est exact. Assurez-vous que le sujet existe dans le cluster spécifié.

Si aucune erreur ne s'est produite jusqu'à présent, consultez les bonnes pratiques dans Maintenir un compte d'éditeur sain.

Vous pouvez également activer les journaux de plate-forme pour un sujet d'importation. Ces journaux vous aident à résoudre les problèmes lorsque vous rencontrez des difficultés pour ingérer des objets dans les sujets d'importation Pub/Sub.