Présentation des playbooks Apigee et Apigee hybride

Vous consultez la documentation d'Apigee et d'Apigee hybrid.
Consultez la documentation d'Apigee Edge.

La résolution des problèmes est à la fois un art et une science. Les efforts continus des équipes d'assistance technique d'Apigee ont pour objectif de démystifier le fonctionnement et d'exposer la science derrière l'identification et la résolution des problèmes.

Que sont les playbooks ?

Développés en collaboration avec les équipes d'assistance technique d'Apigee, les guides de dépannage Apigee sont conçus pour fournir des solutions rapides et efficaces aux erreurs ou à d'autres problèmes que vous pouvez rencontrer lors de l'utilisation des produits Apigee.

Audience

Les guides de dépannage sont destinés aux utilisateurs qui maîtrisent parfaitement Apigee et son architecture, et qui comprennent aussi certains concepts fondamentaux (tels que les règles et les analyses).

Certains problèmes ne peuvent être diagnostiqués et résolus que par des utilisateurs hybrides Apigee, et peuvent nécessiter des connaissances sur des composants internes tels que des datastores Cassandra et Postgres, des processeurs de messages et des routeurs.

Si vous utilisez Apigee, nous vous indiquons clairement quand vous pouvez effectuer les étapes de dépannage indiquées et quand vous devez contacter l'assistance Apigee pour obtenir de l'aide.

Guides

Cette section décrit les playbooks actuels.

Pour filtrer ce tableau, effectuez une ou plusieurs des opérations suivantes : sélectionnez une catégorie, sélectionnez un produit, saisissez un terme de recherche ou cliquez sur un en-tête de colonne pour trier les résultats.

Catégorie Playbook/Description du problème Message d'erreur Playbook applicable à
Cassandra Résoudre les problèmes de restauration de Cassandra Lors de la restauration Cassandra dans Apigee hybrid, vous pouvez rencontrer des erreurs dans les journaux de restauration. Apigee hybrid uniquement
Identification automatique des problèmes Aucune connectivité réseau entre le plan d'exécution et le plan de contrôle

Échec des requêtes de gestion de l'API Apigee :

  • Les produits d'API, les développeurs et les applications ne sont pas renseignés dans l'interface utilisateur d'Apigee.
  • Les déploiements de proxy d'API ne se terminent pas.
  • Les requêtes de gestion d'API Apigee échouent.
Apigee hybrid uniquement
Identification automatique des problèmes Groupe d'environnements d'hôte virtuel manquant L'erreur AIS_VIRTUALHOST_MISSING_ENVGROUP s'affiche après l'exécution de kubectl -n apigee get apigeeissues. Apigee hybrid uniquement
Identification automatique des problèmes Sélecteur d'hôte virtuel manquant L'erreur AIS_VIRTUALHOST_MISSING_SELECTOR s'affiche après l'exécution de kubectl -n apigee get apigeeissues. Apigee hybrid uniquement
Identification automatique des problèmes Incohérence du certificat Ingress Après l'exécution de la commande kubectl -n apigee get apigeeissues, l'erreur AIS_INGRESS_CERT_MISMATCH s'affiche. Apigee hybrid uniquement
Identification automatique des problèmes Expiration du certificat d'entrée Après l'exécution de la commande kubectl -n apigee get apigeeissues, l'erreur AIS_INGRESS_CERT_EXPIREY s'affiche. Apigee hybrid uniquement
Identification automatique des problèmes Expiration du certificat CA mTLS d'entrée L'erreur AIS_INGRESS_MTLS_CA_CERT_EXPIREY s'affiche après l'exécution de la commande kubectl -n apigee get apigeeissues. Apigee hybrid uniquement
Identification automatique des problèmes Certificat CA d'entrée mTLS non valide L'erreur AIS_INGRESS_MTLS_CA_CERT_INVALID s'affiche après l'exécution de kubectl -n apigee get apigeeissues. Apigee hybrid uniquement
Cassandra Échec de la réplication des données Cassandra Lors de la réplication de données lors d'une extension multirégionale, l'état CassandraDataReplication peut afficher un état d'erreur et la réplication des données peut échouer. Apigee hybrid uniquement
Cassandra Les pods Cassandra ne démarrent pas dans la région secondaire Les pods Cassandra ne démarrent pas dans l'une des régions d'une configuration Apigee Hybrid multirégionale. Le message d'erreur node already exists dans les journaux du pod Cassandra ou un avertissement FailedPreStopHook dans l'état du pod Cassandra peuvent s'afficher. Apigee hybrid uniquement
Cassandra Guide de dépannage Cassandra Lorsque vous utilisez kubectl pour afficher les états des pods, vous constatez qu'un ou plusieurs pods Cassandra sont bloqués. Ce guide décrit le diagnostic et la résolution des problèmes liés au datastore Cassandra. Apigee hybrid uniquement
Déploiement Les déploiements du proxy d'API échouent avec un avertissement indiquant qu'il n'existe aucun pod d'exécution actif L'avertissement Aucun pod d'exécution actif s'affiche dans la boîte de dialogue Détails à côté du message d'erreur Problèmes de déploiement sur ENVIRONMENT : REVISION_NUMBER sur la page du proxy d'API. Apigee hybrid uniquement
Passerelle d'entrée Les appels d'API échouent et renvoient des erreurs d'expiration de délai

curl: (7) Failed to connect to example.apis.com port 443: Operation timed out
Apigee hybrid uniquement
Passerelle d'entrée Échecs d'appels d'API avec erreurs TLS

curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443
Apigee hybrid uniquement
Journalisation Résoudre les problèmes liés aux journaux Apigee manquants dans Cloud Logging Dans ce scénario, aucun message d'erreur n'est connu. Apigee et Apigee hybride
Gestion/Interface utilisateur Données incohérentes/non observées pour les entités dans l'interface utilisateur hybride ou via les API de gestion Dans ce scénario, aucun message d'erreur n'est connu. Apigee hybrid uniquement
Configuration du réseau Problèmes de routage des accès avec Apigee Les clients externes ne peuvent pas accéder à Apigee ni s'y connecter de la manière souhaitée. Cela inclut les échecs de connectivité réseau (échec du handshake TLS) ou les réponses 4xx/5xx d'Apigee. Apigee et Apigee hybride
Configuration du réseau Problèmes de connectivité Apigee avec les cibles PSC Southbound Un problème de connexion réseau ou un délai d'expiration TCP dépassé entre Apigee et le service cible renverrait une erreur 503 et ressemblerait à l'erreur ci-dessous dans une session de débogage.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}}
Apigee et Apigee hybride
Autre Augmenter le nombre d'instances dupliquées de propriétés Istio lors du drainage de nœuds Lors du drainage des pods Istio, certains nœuds peuvent ne pas être drainés en raison d'un nombre d'instances dupliquées égal à 1, alors que trois instances dupliquées ou plus sont requises. Pour éviter cela, vous devez définir le nombre minimum d'instances dupliquées pour chaque propriété sur au moins 3. Apigee hybrid uniquement
Autre Guide de dépannage du processeur de messages Un ou plusieurs pods apigee-runtime ne sont pas à l'état Ready. Lorsque vous utilisez kubectl pour décrire un pod apigee-runtime ayant échoué, l'erreur suivante s'affiche :
Readiness probe failed: HTTP probe failed with statuscode: 500
Apigee hybrid uniquement
Autre Imprimer les informations de compilation L'API buildinfo renvoie des informations sur la compilation actuelle pour un composant d'exécution. Ces informations peuvent être utiles si vous devez contacter l'assistance. Apigee hybrid uniquement
Autre Erreurs StreamingPull (taux de 100 %) Si vous voyez dans le tableau de bord des métriques que la méthode google.pubsub.vl.Subscriber.StreamingPull échoue avec 100 % d'erreurs, vous pouvez ignorer le problème en toute sécurité. Il s'agit d'un comportement normal. Apigee hybrid uniquement
Déploiement L'instance ne signale pas l'état du groupe d'environnements Les déploiements de proxys d'API échouent avec l'instance INSTANCE_NAME ne signalant pas l'état du groupe d'environnements ENV_GROUP_NAME dans l'interface utilisateur hybride Apigee. Apigee hybrid uniquement
Déploiement Les déploiements du proxy d'API échouent en raison d'un certificat apigee-serving-cert introuvable ou expiré Les déploiements du proxy d'API échouent avec des messages d'erreur dans les journaux apigee-watcher. Apigee hybrid uniquement
Passerelle d'entrée Augmenter le nombre d'instances dupliquées de propriétés Istio pour éviter les problèmes lors du drainage des nœuds Istio Lors du drainage des pods Istio, certains nœuds peuvent ne pas être drainés en raison d'un nombre d'instances dupliquées égal à 1, alors que 3 instances répliquées ou plus sont requises. Pour éviter cela, vous devez définir le nombre minimum d'instances répliquées pour chaque propriété sur au moins 3. Apigee hybrid uniquement
Configuration du réseau Résolution des problèmes liés à l'absence d'espace d'adresses IP libre Lors du provisionnement d'Apigee, si vous sélectionnez une plage CIDR réseau qui n'est pas totalement disponible, un message d'erreur peut s'afficher. Apigee et Apigee hybride
Configuration du réseau Erreur "Service indisponible" du service 503 d'appairage de VPC avec TARGET_CONNECT_TIMEOUT Ce document explique comment diagnostiquer et corriger les erreurs "503 Service indisponible" liées à TARGET_CONNECT_TIMEOUT lors de l'utilisation de l'appairage de VPC. Apigee
Configuration du réseau 504 Délai avant expiration de la passerelle – Délai d'inactivité de la lecture cible Ce document explique comment diagnostiquer et corriger les erreurs "504 Délai avant expiration de la passerelle" avec un motif TARGET_READ_TIMEOUT. Apigee et Apigee hybride
Autre Résoudre les problèmes liés au blocage d'Apigee hybrid lors de la création ou de la publication de l'état Ce document explique comment réinitialiser les composants Apigee Hybrid lorsqu'ils sont bloqués à l'état creating ou releasing. Apigee hybrid uniquement