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 pour Apache Kafka (Amazon MSK).

Après avoir 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 à 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. Vérifiez le graphique de la métrique Nombre d'octets ingérés.

  5. Si aucune donnée n'est ingérée, sur la page d'informations du sujet, vérifiez si une erreur s'affiche dans le champ État du sujet.

  6. Vous pouvez également vérifier 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.

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

    Code d'erreur Description Corriger
    MSK_PERMISSION_DENIED Erreur lors de la consommation de 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 que le rôle AWS dispose des autorisations de lecture requises. Pour en savoir plus, consultez Créer une stratégie 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 permissions. Pour en savoir plus, consultez Ajouter le rôle É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 Le cluster fourni est inaccessible. 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 l'exactitude du nom du sujet. Assurez-vous que le sujet existe dans le cluster spécifié.

Si aucune erreur ne s'affiche jusqu'à présent, consultez les bonnes pratiques dans Maintenir un éditeur en bon état.

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 des sujets d'importation Pub/Sub.

Apache Kafka® est une marque déposée d'Apache Software Foundation ou de ses filiales aux États-Unis et/ou dans d'autres pays.