Cette page fournit des 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:
Dans la console Google Cloud, accédez à la page d'abonnement Pub/Sub.
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.
Cliquez sur l'abonnement Cloud Storage.
La page des détails de l'abonnement s'ouvre.
Vérifiez si le message d'erreur s'affiche dans l'état de l'abonnement.
En fonction du message d'erreur, accédez à la section correspondante de cette page pour résoudre le problème.
Une fois le problème résolu, l'abonnement revient à un état opérationnel.
Impossible de créer ou de mettre à jour l'abonnement
Voici quelques-uns des problèmes courants que vous pouvez rencontrer lorsque vous rencontrez des difficultés pour 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 mettez à 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 les autorisations appropriées, 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 dispose des 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 la façon dont Pub/Sub écrit les messages dans le bucket. Si une modification entraîne un problème, le champ d'état de l'abonnement est défini 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, qui peut être l'une des suivantes:
Bucket introuvable: le bucket a été supprimé. Créez à nouveau le bucket ou mettez à jour l'abonnement pour utiliser un bucket existant.
Autorisation de bucket refusée: le compte de service Pub/Sub n'est plus autorisé à écrire dans le bucket. Vérifiez si le compte de service dispose des autorisations appropriées.
Tant qu'un abonnement Pub/Sub est à l'état d'erreur, les messages ne sont pas écrits dans le bucket et restent en attente dans les tâches d'abonnement. Notez que les messages ne sont pas distribués à un sujet de lettres mortes associé, si celui-ci est configuré. Les messages non confirmés sont conservés pendant 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, l'activation du tri des messages sur votre abonnement Cloud Storage peut entraîner l'écriture des messages dans Cloud Storage, mais ne pas être finalisées et 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 de désactiver le tri des messages si votre cas d'utilisation ne l'exige pas.
Définir une taille de fichier maximale trop basse pour votre abonnement Cloud Storage peut également avoir un impact négatif sur les performances. Une taille de fichier trop faible peut amener Pub/Sub à créer de nombreux objets Cloud Storage ne comportant qu'un petit nombre de messages dans chaque objet. Les frais supplémentaires liés à la création et à la finalisation d'objets ralentissent le traitement des messages. Pour de meilleures performances, envisagez d'augmenter la taille de fichier maximale pour votre abonnement Cloud Storage ou de supprimer la restriction de taille de fichier.
Limites de quota
Il est également possible que votre projet ait atteint son quota de débit push Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber). Pour vérifier si vous rencontrez des limites de quota, examinez la métrique de requêtes push (subscription/push_request_count) afin de détecter toute erreur resource_exhausted.
Passez en revue les quotas de votre projet et vérifiez qu'il vous en reste suffisamment. Accédez à IAM et administration > Quotas dans le projet contenant votre abonnement Pub/Sub. Recherchez le quota pubsub.googleapis.com/regionalpushsubscriber. Si vous atteignez la limite de quota, vous pouvez demander un quota supérieur.
L'abonnement crée plus de fichiers que prévu
Pour améliorer l'évolutivité, votre abonnement Cloud Storage peut être géré par plusieurs backends Pub/Sub. Chaque backend écrit dans un fichier Cloud Storage distinct. Il est donc possible que Cloud Storage crée 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 augmenter les paramètres de traitement par lot des fichiers de votre abonnement pour autoriser les fichiers plus volumineux. Vous pouvez également post-traiter les fichiers en les composant dans un plus petit nombre de fichiers plus volumineux.
Étapes suivantes
- Si vous rencontrez toujours des problèmes avec votre abonnement Cloud Storage, consultez la page Obtenir de l'aide.