Référence du message d'erreur

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

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

Problèmes liés à Analytics

Ces articles expliquent comment résoudre les problèmes de non-affichage des données analytiques dans les tableaux de bord Analytics ou dans les rapports personnalisés.

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

Expiration des rapports Analytics

soit :

Délai du rapport expiré
Il est possible qu'aucun message d'erreur ne s'affiche, sauf si l'espace disque est complètement rempli sur le serveur Postgres. Le serveur PostgreSQL est à court d'espace disque
Aucune erreur n'est détectée. La variable personnalisée n'est pas visible dans les rapports personnalisés Analytics
No traffic in the selected date range Données qui ne s'affichent pas dans les tableaux de bord d'analyse
Il explique comment effectuer une tâche couramment demandée. Ajouter et supprimer des composants d'analyse dans des groupes d'analyse
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 liés au 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 d'erreur Playbook
Error: Call timed out; either server is down or server is not reachable Erreur de délai avant expiration
Unexpected error Error while fetching children for path Erreur lors de la récupération des enfants pour le chemin
Error while accessing datastore;Please retry later Erreur lors de l'accès à 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 articles vous aident à résoudre les problèmes que vous pouvez rencontrer lorsque vous utilisez le portail pour les développeurs. Avant d'essayer de résoudre les problèmes liés au portail pour les développeurs, assurez-vous de bien comprendre son fonctionnement, comme expliqué dans la section Présentation du dépannage du portail pour les développeurs.
Message ou description d'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. OU There was an error trying to create the App. Please try again later. Problèmes de communication avec le 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 d'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 constaterez des problèmes, comme expliqué dans la section Symptôme de la page 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 lors de la modification de 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 d'erreur Playbook
Aucun message d'erreur ne s'affiche. 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 OpenLDAP

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

Message ou description d'erreur Playbook
Unknown username and password combination. Le 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. La réplication LDAP ne s'effectue 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 d'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 du 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 de handshake SSL
HTTP/1.1 503 Service Unavailable OU 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
Échecs de poignée de main SSL : certificat client incorrect
HTTP/1.1 504 Gateway Timeout OU 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Expiration du délai de la passerelle

Problèmes Zookeeper

Les sujets suivants vous aideront à résoudre les problèmes courants liés à Zookeeper.
Message ou description d'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'interface utilisateur d'Edge peut afficher l'erreur suivante:

Error Fetching Deployments Error while checking path existence for path: path 		Erreurs de perte de connexion Zookeeper
Les problèmes liés aux données, communément appelés problèmes de câblage, peuvent se manifester de différentes manières. Pour en savoir plus, consultez la page Problèmes de données Zookeeper. Problèmes de 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 et journaux de diagnostic

Ces sections 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 d'analyseur de paquets TCP/IP (tcpdump)
    Cet outil est un outil d'analyseur de paquets de 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.
  • Dumps de tas
    Les dump de tas sont un instantané de la mémoire d'un processus Java. Ils contiennent des informations sur les objets et les classes Java dans le tas de mémoire au moment de la collecte du vidage de tas.
  • Copie 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 pile.