Référence du message d'erreur

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Cette page contient des liens vers des playbooks de dépannage pour les erreurs et autres problèmes que vous pouvez rencontrer lorsque vous utilisez Apigee Edge. Chaque playbook de dépannage explique comment diagnostiquer et résoudre chaque type de problème.

Problèmes liés à Analytics

Ces sujets expliquent comment résoudre les problèmes liés aux données Analytics qui ne s'affichent pas dans les tableaux de bord Analytics ni dans les rapports personnalisés.

Message ou description de l'erreur Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Délai d'inactivité des rapports Analytics

soit :

Délai d'inactivité du rapport
Vous ne verrez peut-être aucun message d'erreur, sauf si l'espace disque est complètement saturé sur le serveur Postgres. Espace disque insuffisant sur le serveur Postgres
Aucune erreur n'est observée. Variable personnalisée non visible dans les rapports personnalisés Analytics
No traffic in the selected date range Données ne s'affichant pas dans les tableaux de bord Analytics
Le sujet explique comment effectuer une tâche courante. Ajouter et supprimer des composants Analytics dans des groupes Analytics
Could not get data for path Les dimensions personnalisées ne s'affichent pas lorsque plusieurs groupes d'axes ont été configurés

Erreurs de déploiement

Le déploiement de proxys d'API peut échouer pour diverses raisons, telles que des problèmes de connectivité réseau entre les serveurs Edge, des problèmes avec le datastore Cassandra, des exceptions ZooKeeper et des erreurs dans le bundle de proxy d'API. Cette section fournit des informations et des conseils sur certaines procédures spécifiques à suivre pour résoudre les erreurs de déploiement.
Message ou description de l'erreur Playbook
Error: Call timed out; either server is down or server is not reachable Erreur de délai d'inactivité
Unexpected error Error while fetching children for path Erreur lors de la récupération des enfants pour le chemin d'accès
Error while accessing datastore;Please retry later Erreur lors de l'accès au datastore
Configuration failed, associated contexts = [] Échec de la configuration
Unexpected error occurred while processing the updates, associated contexts = [] Erreur lors du traitement des mises à jour

Erreurs du portail des développeurs

Ces sujets vous aident à résoudre les problèmes que vous pouvez rencontrer lorsque vous utilisez le portail des développeurs. Avant de tenter de résoudre les problèmes liés au portail des développeurs, assurez-vous de bien comprendre son fonctionnement de base, comme expliqué dans la présentation du dépannage du portail des développeurs.
Message ou description de l'erreur Playbook
An internal error has occurred. Please retry your request. Erreur interne du portail des développeurs
The website encountered an unexpected error. Please try again later. OR There was an error trying to create the App. Please try again later. Problèmes de communication du portail des développeurs

Problèmes de monétisation

Les sujets suivants vous aideront à résoudre les problèmes courants de monétisation.

Message ou description de l'erreur Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Développeur suspendu
Vous ne verrez peut-être aucun message d'erreur, mais vous rencontrerez des problèmes comme expliqué dans la section Symptômes de Problèmes de configuration de la monétisation. Problèmes de configuration de la monétisation

Problèmes liés au routeur Edge

Le routeur Edge est implémenté avec NGINX. Lors du processus de mise à niveau d'Edge ou lorsque vous modifiez la configuration du routeur, des erreurs de configuration NGINX peuvent s'afficher. Le sujet suivant vous aidera à résoudre ces problèmes.

Message ou description de l'erreur Playbook
Vous ne verrez aucun message d'erreur. Toutefois, vous ne pourrez peut-être pas exécuter vos proxys d'API en raison de fichiers de configuration incorrects. Fichiers de configuration incorrects
429 Too Many Requests: Tuning Nginx Router connection limits 429 Trop de requêtes

Problèmes liés à OpenLDAP

Les sujets suivants vous aideront à résoudre les problèmes courants liés à OpenLDAP.

Message ou description de l'erreur Playbook
Unknown username and password combination. SMTP est désactivé et les utilisateurs doivent réinitialiser leur mot de passe
Aucune erreur ne s'affiche. L'UI Edge n'affiche tout simplement pas la liste des utilisateurs qui auraient dû être répliqués sur tous les serveurs OpenLDAP. LDAP ne se réplique pas.
SLAPD Dead But Pid File Exists Impossible de démarrer OpenLDAP
Unknown username and password combination. Corruption des données OpenLDAP

Erreurs d'exécution

Les sujets suivants vous aideront à résoudre les problèmes d'exécution courants.

Message ou description de l'erreur Playbook
HTTP/1.1 500 Internal Server Error OU 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 Erreur interne au serveur
HTTP/1.1 502 Bad Gateway OU 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 Passerelle incorrecte
HTTP/1.1 503 Service Unavailable OU HTTP/1.1 503 Service Unavailable: Back-end server is at capacity OU 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Service Indisponible
HTTP/1.1 503 Service Unavailable OU Received fatal alert: handshake_failure Échecs du handshake SSL
HTTP/1.1 503 Service Unavailable 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
Échecs du handshake SSL – Certificat client incorrect
HTTP/1.1 504 Gateway Timeout 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Expiration de la passerelle

Problèmes liés à Zookeeper

Les sujets suivants vous aideront à résoudre les problèmes courants liés à Zookeeper.
Message ou description de l'erreur Playbook
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

OU

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

OU

L'UI Edge peut afficher cette erreur :

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper Erreurs de perte de connexion
Les problèmes liés aux données, généralement appelés problèmes de câblage, peuvent se manifester de plusieurs manières. Pour en savoir plus, consultez Problèmes liés aux données Zookeeper. Problèmes liés aux données Zookeeper
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Impossible de démarrer Zookeeper

Outils de diagnostic et journaux

Ces sujets décrivent les outils et les journaux que vous pouvez utiliser pour diagnostiquer certains types de problèmes que vous pouvez rencontrer lorsque vous utilisez Apigee Edge.

  • Utilitaire de capture de paquets TCP/IP (tcpdump)
    L'outil tcpdump est un outil de capture de paquets en ligne de commande qui vous permet de capturer ou de filtrer les paquets TCP/IP reçus ou transférés sur un réseau.
  • Empreintes de la mémoire
    Les empreintes de la mémoire sont un instantané de la mémoire d'un processus Java. Elles contiennent des informations sur les objets et les classes Java dans le tas au moment où l'empreinte de la mémoire est collectée.
  • Copies de thread
    Une copie de thread est un instantané de l'état de tous les threads d'un processus Java en cours d'exécution. L'état de chaque thread est présenté avec le contenu de sa pile, appelé trace de la pile.