Référence du message d'erreur

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

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 d'analyse

Ces articles expliquent comment résoudre les cas où les données d'analyse ne s'affichent pas dans les tableaux de bord Analytics ou dans les rapports personnalisés.

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

Les rapports Analytics expirent

soit :

Le rapport a expiré
Il se peut qu'aucun message d'erreur ne s'affiche, sauf si l'espace disque est entièrement rempli sur le serveur Postgres. Le serveur PostgreSQL est à court d'espace disque
Aucune erreur n'est observée. Variable personnalisée non visible dans les rapports personnalisés d'analyse
No traffic in the selected date range Données non affichées dans les tableaux de bord d'analyse
Ce thème explique comment effectuer une tâche fréquemment demandée. Ajouter et supprimer des composants d'analyse dans des groupes d'analyse
Could not get data for path Les dimensions personnalisées n'apparaissent pas lorsque plusieurs groupes d'axes ont été configurés

Erreurs de déploiement

Le déploiement des 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 ou des erreurs dans le groupe de proxys d'API. Cette section fournit des informations et des conseils sur certaines procédures spécifiques pouvant être suivies pour résoudre les erreurs de déploiement.
Message d'erreur ou description 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 éléments 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 = [] Informations de traitement d'erreurs

Erreurs liées au portail des développeurs

Ces articles vous aideront à résoudre les problèmes que vous pouvez rencontrer lorsque vous utilisez le portail des développeurs. Avant d'essayer de résoudre les problèmes liés au portail des développeurs, assurez-vous que vous maîtrisez les bases de son fonctionnement, comme expliqué dans la section Présentation du dépannage du portail des développeurs.
Message d'erreur ou description 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 du portail des développeurs

Problèmes de monétisation

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

Message d'erreur ou description Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Suspendu par un développeur
Il se peut qu'aucun message d'erreur ne s'affiche, mais vous rencontrerez des problèmes, comme expliqué dans la section Symptôme de l'article Problèmes de configuration de la monétisation. Problèmes de configuration de la monétisation

Problèmes liés à Edge Router

Le routeur périphérique est implémenté avec NGINX. Au cours du processus de mise à niveau en périphérie ou lors de la modification de la configuration du routeur, des erreurs de configuration NGINX peuvent s'afficher. La rubrique suivante vous aidera à résoudre ces problèmes.

Message d'erreur ou description 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

Problèmes OpenLDAP

Les rubriques suivantes vous aideront à résoudre les problèmes OpenLDAP courants.

Message d'erreur ou description Playbook
Unknown username and password combination. SMTP est désactivé et les utilisateurs doivent réinitialiser le mot de passe
Aucune erreur n'apparaît. L'interface utilisateur Edge n'affiche tout simplement pas la liste des utilisateurs qui auraient dû être répliqués sur tous les serveurs OpenLDAP. LDAP n'est pas répliqué.
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 articles suivants vous aideront à résoudre les problèmes d'exécution courants.

Message d'erreur ou description 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 non disponible
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 handshake SSL – Certificat client incorrect
HTTP/1.1 504 Gateway Timeout OU 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Expiration de la passerelle

Problèmes liés à ZooKeeper

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

Error Fetching Deployments Error while checking path existence for path: path 		Erreurs de perte de connexion Zoookeeper
Les problèmes liés aux données, communément appelés problèmes de câblage, peuvent se manifester. Pour plus d'informations, consultez la page Problèmes liés aux données dans Kotlin. Problèmes de données de Zoookeeper
+ 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 articles décrivent les outils et les journaux que vous pouvez utiliser pour diagnostiquer certains types de problèmes que vous pouvez rencontrer lors de l'utilisation d'Apigee Edge.

  • Utilitaire de détection de paquets TCP/IP (tcpdump)
    L'outil de détection de paquets de ligne de commande tcpdump. Il vous permet de capturer ou de filtrer les paquets TCP/IP reçus ou transférés sur un réseau.
  • Empreinte de la mémoire
    Les empreintes de la mémoire 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 où l'empreinte de la mémoire est collectée.
  • Empreinte 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".