Ce document fournit des 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 :
Dans la console, accédez à la page Sujets.
Cliquez sur le sujet d'importation Amazon MSK que vous souhaitez résoudre.
Sur la page d'informations du sujet, cliquez sur l'onglet Métriques.
Vérifiez le graphique de la métrique Nombre d'octets d'ingestion.
Si aucune donnée n'est ingérée, vérifiez sur la page d'informations du sujet si une erreur s'affiche dans le champ État du sujet.
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 sujet, cliquez sur l'onglet Métriques.
Voici une liste des erreurs que vous pouvez rencontrer:
Code d'erreur Description Corriger MSK_PERMISSION_DENIEDErreur lors de la consommation des données Amazon MSK en raison de problèmes d'autorisation. Vérifiez l'exactitude de l'ARN du rôle AWS et assurez-vous qu'il 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 de confiance 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_DENIEDErreur 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 Éditeur Pub/Sub au compte de service Pub/Sub. CLUSTER_NOT_FOUNDLe cluster fourni est introuvable. Vérifiez l'exactitude de l'ARN du cluster. Assurez-vous que le cluster existe et qu'il est accessible. TOPIC_NOT_FOUNDLe sujet Kafka fourni n'a pas été trouvé. Vérifiez l'exactitude du nom du sujet. Assurez-vous que le sujet existe dans le cluster spécifié.
Si aucune erreur ne s'affiche à ce stade, consultez les bonnes pratiques de la section Gérer un éditeur sain.
Vous pouvez également activer les journaux de la plate-forme pour un sujet d'importation. Ces journaux vous aident à résoudre les problèmes d'ingestion d'objets dans des sujets d'importation Pub/Sub.