Résoudre les problèmes liés à un sujet d'importation Cloud Storage

Ce document fournit des conseils de dépannage courants pour les sujets d'importation Cloud Storage.

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 des 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 Cloud Storage que vous souhaitez résoudre.

  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 d'ingestion.

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

  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 sujet, cliquez sur l'onglet Métriques.

    Pour en savoir plus sur ces métriques, consultez la section Métriques pour surveiller les sujets d'importation.

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

    Code d'erreur Description Corriger
    CLOUD_STORAGE_PERMISSION_DENIED Erreur lors de l'utilisation des données Cloud Storage en raison de problèmes d'autorisation. Vérifiez que le compte de service Pub/Sub dispose des autorisations nécessaires pour accéder au bucket Cloud Storage. Assurez-vous que le compte de service dispose des autorisations suivantes:
    • storage.objects.list: pour lister les objets d'un bucket.
    • storage.objects.get: pour lire les objets d'un bucket.
    • storage.buckets.get: pour obtenir l'emplacement du bucket et vérifier qu'il existe.

    Pour en savoir plus, consultez les conditions préalables à la création d'un sujet Cloud Storage.

    PUBLISH_PERMISSION_DENIED Erreur de publication sur le sujet 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.
    BUCKET_NOT_FOUND Le bucket Cloud Storage spécifié est introuvable. Vérifiez l'exactitude du nom du bucket.
    TOO_MANY_OBJECTS Le bucket Cloud Storage contient trop d'objets. L'ingestion est suspendue. L'ingestion reprend lorsque le nombre d'objets dans le bucket est inférieur à 50 millions. La limite pour les objets est de 50 millions. Réduisez le nombre d'objets dans le bucket ou contactez l'assistance Google Cloud pour obtenir de l'aide.

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 Cloud Storage. Ces journaux vous aident à résoudre les problèmes d'ingestion d'objets dans des sujets d'importation Pub/Sub.