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.
Qu'est-ce qu'un playbook ?
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.
Pour accéder aux playbooks de dépannage, vous pouvez essayer de rechercher des messages d'erreur spécifiques à l'aide du champ de recherche situé en haut de cette page, ou utiliser le sommaire à gauche pour parcourir la bibliothèque.
Cible
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
Le tableau suivant décrit les guides actuels :
Cassandra |
||
|---|---|---|
| Guide/Description du problème | Message d'erreur | Guide applicable à |
| É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.
|
Utilisateurs de Apigee hybrid uniquement |
| 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.
|
Utilisateurs de Apigee hybrid uniquement |
| 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 dans l'état Pending.
L'état Pending indique que Kubernetes ne peut pas planifier le pod sur un nœud : le pod ne peut pas être créé.
|
Utilisateurs de Apigee hybrid uniquement |
Déploiement |
||
|---|---|---|
| Guide/Description du problème | Message d'erreur | Guide applicable à |
| 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. | Utilisateurs de Apigee hybrid uniquement |
Passerelle d'entrée |
||
|---|---|---|
| Guide/Description du problème | Message d'erreur | Guide applicable à |
| Les appels d'API échouent avec des erreurs d'expiration de délai |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Utilisateurs de Apigee hybrid uniquement |
| Échec des appels d'API avec des erreurs TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Utilisateurs de Apigee hybrid uniquement |
Gestion/Interface utilisateur |
||
|---|---|---|
| Guide/Description du problème | Message d'erreur | Guide applicable à |
| 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. | Utilisateurs de Apigee hybrid uniquement |
Autre |
||
|---|---|---|
| Guide/Description du problème | Message d'erreur | Guide applicable à |
| 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. | Utilisateurs de Apigee hybrid uniquement |
| 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 |
Utilisateurs de Apigee hybrid uniquement |
| 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.
|
Utilisateurs de Apigee hybrid uniquement |
| 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.
|
Utilisateurs de Apigee hybrid uniquement |