Utilisez l'outil gcpdiag pour identifier et résoudre les problèmes potentiels de distribution des abonnements avec extraction.
Utiliser l'outil gcpdiag
gcpdiag est un outil Open Source. Il ne s'agit pas d'un produit Google Cloud officiellement pris en charge.
Vous pouvez utiliser l'outil gcpdiag pour vous aider à identifier et à résoudre les problèmes liés au projet Google Cloud. Pour plus d'informations, consultez le projet gcpdiag sur GitHub.
L'outil gcpdiag vous aide à identifier les problèmes de distribution par extraction Pub/Sub en effectuant les vérifications suivantes :
- Erreurs de quota : évalue les journaux de l'explorateur de journaux pour vérifier s'il existe des erreurs de quota dans les régions et les zones.
- Qualification du débit : effectue des vérifications sur l'état de la latence de diffusion d'un abonnement.
Pour obtenir la liste des étapes d'évaluation de la livraison par extraction gcpdiag, consultez Étapes potentielles.
Exécuter la commande gcpdiag
Vous pouvez exécuter la commande gcpdiag à partir de Google Cloud CLI ou dans un conteneur Docker.
ConsoleGoogle Cloud
- Terminez l'exécution, puis copiez la commande suivante.
- Ouvrez la console Google Cloud et activez Cloud Shell. Ouvrir la console Cloud
- Collez la commande copiée.
- Exécutez la commande
gcpdiag, qui télécharge l'image Dockergcpdiag, puis effectue des vérifications de diagnostic. Le cas échéant, suivez les instructions de sortie pour corriger les échecs de vérification.
gcpdiag runbook pubsub/pull-subscription-delivery \
--project=PROJECT_ID \
--parameter subscription_name=SUBSCRIPTION_NAMEDocker
Vous pouvez exécuter gcpdiag à l'aide d'un wrapper qui démarre gcpdiag dans un conteneur Docker. Docker ou Podman doivent être installés.
- Copiez et exécutez la commande suivante sur votre station de travail locale.
curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag
- Exécutez la commande
gcpdiag../gcpdiag runbook pubsub/pull-subscription-delivery \ --project=PROJECT_ID \ --parameter subscription_name=SUBSCRIPTION_NAME
Affichez les paramètres disponibles pour ce runbook.
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet à évaluer
- SUBSCRIPTION_NAME : nom de l'abonnement à évaluer dans votre projet
Options utiles :
--universe-domain: le cas échéant, le domaine Cloud souverain du partenaire de confiance hébergeant la ressource.--parameterou-p: paramètres du runbook.
Pour obtenir la liste et la description de toutes les options de l'outil gcpdiag, consultez les instructions d'utilisation de gcpdiag.