Résoudre les problèmes liés aux abonnements Cloud Storage

Cette page fournit quelques conseils de dépannage courants pour les abonnements Cloud Storage.

Vérifier l'état d'un abonnement Cloud Storage

Pour vérifier l'état d'un abonnement, procédez comme suit:

  1. Dans la console Google Cloud, accédez à Pub/Sub page d'abonnement.

    Accéder aux abonnements

  2. Vérifiez l'icône d'état de votre abonnement Cloud Storage.

    • Si l'icône est une coche verte, cela signifie que l'abonnement est opérationnel.

    • Si l'icône est un point d'exclamation rouge, cela signifie que l'abonnement est en état d'erreur.

  3. Cliquez sur l'abonnement Cloud Storage.

    La page des détails de l'abonnement s'ouvre.

  4. Vérifiez si le message d'erreur s'affiche dans l'état de l'abonnement.

  5. En fonction du message d'erreur, accédez à la section correspondante pour résoudre le problème.

Une fois le problème résolu, l'abonnement revient à est opérationnel.

Impossible de créer ou de mettre à jour l'abonnement

Voici quelques-uns des problèmes courants que vous pourriez rencontrer si vous rencontrez des difficultés créer ou mettre à jour un abonnement Cloud Storage.

Erreur "Bucket introuvable"

Si le bucket que vous spécifiez dans le workflow de création ou de mise à jour d'un abonnement n'existe pas, le workflow renvoie une erreur bucket not found. Dans la console Google Cloud, le message ressemble à ce qui suit:

The Cloud Storage bucket specified cannot be found.

Pour résoudre le problème, créez le bucket. ou mettre à jour votre abonnement Cloud Storage pour utiliser un bucket existant.

Erreur de compte de service

Si vous n'avez pas configuré le compte de service Pub/Sub avec le les bonnes autorisations, puis le workflow de création ou de mise à jour d'un abonnement renvoie une erreur. Dans la console Google Cloud, le message ressemble à ce qui suit:

Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.

Pour résoudre le problème, vérifiez si le compte de service les autorisations appropriées.

L'état de l'abonnement affiche un point d'exclamation rouge.

Si vous modifiez le bucket après avoir créé un abonnement, cela peut affecter comment Pub/Sub écrit les messages dans le bucket. Si une modification entraîne un numéro, le champ "state" de l'abonnement définies sur un état d'erreur ;

Sur la page d'informations de l'abonnement, vérifiez l'état du champ Subscription state. Le champ Subscription state fournit une erreur plus spécifique, Il peut s'agir de l'un des éléments suivants:

  • Bucket introuvable: le bucket a été supprimé. Créez à nouveau le bucket ou mettez à jour le pour utiliser un bucket existant.

  • Autorisation de bucket refusée: le compte de service Pub/Sub n'a plus l'autorisation d'écrire dans le bucket. Vérifiez si le compte de service les autorisations appropriées.

Lorsqu'un abonnement Pub/Sub est en état d'erreur, ne sont pas écrits dans le bucket et restent les tâches d'abonnement en attente. Notez que les messages ne sont pas distribués à un associé à une lettre morte ; si elle est configurée. Les messages non confirmés sont conservés pour la période définie dans message_retention_duration (sept jours par défaut).

L'abonnement traite les messages très lentement

Certains paramètres d'abonnement peuvent ralentir le traitement des messages.

Par exemple, activer le tri des messages sur Cloud Storage peut entraîner l'écriture des messages dans Cloud Storage, finalisées pour retarder les messages suivants ayant la même clé de tri. Pour de meilleures performances, envisagez d'utiliser un plus large éventail de clés de tri lorsque vous publiez des messages, ou désactivez leur tri ne l'exige pas.

Vous avez défini une taille de fichier maximale trop basse pour votre abonnement Cloud Storage. peut aussi avoir un impact négatif sur les performances. La taille de fichier maximale est trop basse. peut amener Pub/Sub à créer de nombreux objets Cloud Storage avec une seule un petit nombre de messages dans chaque objet. Les frais généraux supplémentaires la création et la finalisation d'objets ralentit le traitement des messages. Pour de meilleures performances, envisagez d'augmenter la taille de fichier maximale. pour votre abonnement Cloud Storage ou en supprimant la restriction de taille de fichier.

Limites de quota

Il est également possible que votre projet ait atteint son stade de transfert Pub/Sub quota de débit (pubsub.googleapis.com/regionalpushsubscriber). Pour vérifier si vous rencontrez des limites de quota, examinez les requêtes push statistique (subscription/push_request_count) pour les éventuelles erreurs resource_exhausted.

Passez en revue les quotas de votre projet et vérifiez que vous disposez d'un quota suffisant restant(s). Accédez à IAM et Admin > Les quotas du projet contenant votre abonnement Pub/Sub. Recherchez le Quota de pubsub.googleapis.com/regionalpushsubscriber. Si vous atteignez le limite de quota, vous pouvez demander un quota plus élevé.

L'abonnement crée plus de fichiers que prévu

Pour améliorer l'évolutivité, votre abonnement Cloud Storage peuvent être gérées par plusieurs backends Pub/Sub. Chaque backend écrit dans un fichier Cloud Storage distinct. Vous pourriez donc constater votre espace de stockage Cloud Storage à créer plus de fichiers que prévu, en particulier pour les charges de travail à faible débit.

Ce comportement est normal. Si vous souhaitez réduire le nombre de fichiers créés par l'abonnement, vous pouvez envisager d'augmenter les paramètres de traitement par lot des fichiers pour accepter des fichiers plus volumineux. Vous pouvez également post-traiter les fichiers en les rédiger dans un plus petit nombre de fichiers plus volumineux.

Étape suivante

  • Si vous rencontrez toujours des problèmes avec Cloud Storage consultez l'article Obtenir de l'aide.