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 :
|
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 |