Résoudre les problèmes de diffusion par pull

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

  1. Terminez l'exécution, puis copiez la commande suivante.
  2. gcpdiag runbook pubsub/pull-subscription-delivery \
      --project=PROJECT_ID \
      --parameter subscription_name=SUBSCRIPTION_NAME
  3. Ouvrez la console Google Cloud et activez Cloud Shell.
  4. Ouvrir la console Cloud
  5. Collez la commande copiée.
  6. Exécutez la commande gcpdiag, qui télécharge l'image Docker gcpdiag, puis effectue des vérifications de diagnostic. Le cas échéant, suivez les instructions de sortie pour corriger les échecs de vérification.

Docker

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.

  1. Copiez et exécutez la commande suivante sur votre station de travail locale.
    curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag
  2. 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 :

Pour obtenir la liste et la description de toutes les options de l'outil gcpdiag, consultez les instructions d'utilisation de gcpdiag.