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 :
Dans la Google Cloud console, accédez à la page des abonnements Pub/Sub.
Vérifiez l'icône de l'état de votre abonnement de stockage Cloud Storage.
Si l'icône est une coche verte, l'abonnement est en bon état.
Si l'icône est un point d'exclamation rouge, l'abonnement est en état d'erreur.
Cliquez sur l'abonnement Cloud Storage.
La page des détails de l'abonnement s'ouvre.
Recherchez le message d'erreur dans É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 normal.
Impossible de créer ou de modifier un abonnement
Voici quelques-uns des problèmes courants que vous pouvez rencontrer si vous ne parvenez pas à créer ou à modifier un abonnement de stockage Cloud Storage.
Erreur "Bucket introuvable"
Si le bucket que vous spécifiez dans le workflow de création ou de modification d'abonnement n'existe pas, le workflow renvoie une erreur bucket not found.
Dans la Google Cloud console, le message ressemble à ceci :
The Cloud Storage bucket specified cannot be found.
Pour résoudre le problème, créez le bucket ou mettez à jour votre abonnement de stockage 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 modification d'abonnement renvoie une erreur. Dans la Google Cloud console, le message ressemble à ceci :
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 avoir une incidence sur 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é. Recréez le bucket ou modifiez 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.
Lorsqu'un abonnement Pub/Sub est en é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é,
s'il 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, si vous activez l'ordre des messages dans votre abonnement Cloud Storage, les messages peuvent être écrits dans Cloud Storage, mais ne pas être finalisés, ce qui retarde les messages suivants avec la même clé de commande. Pour de meilleures performances, envisagez d'utiliser un plus large éventail de clés de commande lors de la publication de messages ou de désactiver l'ordre des messages si votre cas d'utilisation ne le nécessite pas.
Définir une taille maximale de fichier trop faible pour votre abonnement Cloud Storage peut également avoir un impact négatif sur les performances. Une taille maximale de fichier trop faible peut entraîner la création par Pub/Sub de nombreux objets Cloud Storage avec seulement 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 le paramètre de taille maximale des fichiers pour votre abonnement Cloud Storage ou de supprimer la restriction de taille des fichiers.
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 des requêtes push (subscription/push_request_count)
pour détecter les erreurs resource_exhausted.
Consultez les quotas de votre projet et vérifiez qu'il vous reste suffisamment de quota. 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 ajustement de quota.
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. Vous pouvez donc constater que Cloud Storage crée plus de fichiers que prévu, en particulier pour les charges de travail à faible débit.
Cela est tout à fait 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 de votre abonnement pour autoriser des fichiers plus volumineux. Vous pouvez également post-traiter les fichiers en les composant en un plus petit nombre de fichiers plus volumineux.
Étape suivante
- Si vous rencontrez toujours des problèmes avec votre abonnement Cloud Storage, consultez Obtenir de l'aide.