You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/api-platform/reference/variables-reference). info

This page contains links to troubleshooting playbooks for errors and other issues that you may
encounter when using Apigee Edge. Each troubleshooting playbook explains how to diagnose and resolve
each type of problem.

> [!NOTE]
> **Note:** Some types of problems can only be resolved if you are an Edge Private Cloud user. Whenever possible, we identify which troubleshooting procedures can be performed by Private Cloud users, Public Cloud users, or both.

## Analytics problems

These topics explain how to troubleshoot cases where analytics data does not show up in the
Analytics dashboards or in custom reports.

| Error message or description | Playbook |
|---|---|
| `The report timed out: Try again with a smaller date range or a larger aggregation interval.` | [Analytics reports timing out](https://docs.apigee.com/api-platform/troubleshoot/analytics/analytics-reports-timing-out) Or: [Report timed out](https://docs.apigee.com/api-platform/troubleshoot/analytics/report-timed-out) |
| *You may not observe any error message unless the disk space is completely filled on the Postgres Server.* | [Postgres server running out of disk space](https://docs.apigee.com/api-platform/troubleshoot/analytics/postgres-server-running-out-disk-space) |
| *No errors are observed.* | [Custom variable not visible to analytics custom reports](https://docs.apigee.com/api-platform/troubleshoot/analytics/custom-variable-not-visible-analytics-custom-reports) |
| `No traffic in the selected date range` | [Data not showing up on analytics dashboards](https://docs.apigee.com/api-platform/troubleshoot/analytics/data-not-showing-analytics-dashboards) |
| *The topic explains how to do a commonly requested task.* | [Adding and deleting analytics components in analytics groups](https://docs.apigee.com/api-platform/troubleshoot/analytics/add-remove-postgres-nodes) |
| `Could not get data for path` | [Custom Dimensions not appearing when multiple axgroups have been configured](https://docs.apigee.com/api-platform/troubleshoot/analytics/custom-dimensions-not-appearing) |

## Deployment errors

Deployment of API proxies might fail due to various reasons such as network connectivity issues between Edge servers, issues with the Cassandra datastore, ZooKeeper exceptions, and errors in the API proxy bundle. This section provides information and guidance on some specific procedures that can be followed for troubleshooting deployment errors.

| Error message or description | Playbook |
|---|---|
| `Error: Call timed out; either server is down or server is not reachable` | [Timeout Error](https://docs.apigee.com/api-platform/troubleshoot/deployment/timeout-error) |
| `Unexpected error Error while fetching children for path` | [Error Fetching Children for Path](https://docs.apigee.com/api-platform/troubleshoot/deployment/error-fetching-children-path) |
| `Error while accessing datastore;Please retry later` | [Error Accessing Datastore](https://docs.apigee.com/api-platform/troubleshoot/deployment/error-accessing-datastore) |
| `Configuration failed, associated contexts = []` | [Configuration failed](https://docs.apigee.com/api-platform/troubleshoot/deployment/deployment-error-configuration-failed) |
| `Unexpected error occurred while processing the updates, associated contexts = []` | [Error Processing Updates](https://docs.apigee.com/api-platform/troubleshoot/deployment/error-processing-updates) |

## Developer Portal errors

These topics provide help you with issues you may encounter when using the developer portal. Before attempting to fix developer portal problems, be sure you have a basic understanding of how the developer portal works, as explained in [Developer
Portal Troubleshooting Overiew](https://docs.apigee.com/api-platform/troubleshoot/devportal/developer-portal-troubleshooting-overview).

| Error message or description | Playbook |
|---|---|
| `An internal error has occurred. Please retry your request.` | [Developer Portal Internal Error](https://docs.apigee.com/api-platform/troubleshoot/devportal/developer-portal-internal-error) |
| `The website encountered an unexpected error. Please try again later.` OR `There was an error trying to create the App. Please try again later.` | [Developer Portal Communication Issues](https://docs.apigee.com/api-platform/troubleshoot/devportal/developer-portal-communication-issues) |

## Monetization problems

The following topics will help you troubleshoot and fix common Monetization
problems.

| Error message or description | Playbook |
|---|---|
| ``` <error> <messages> <message>Exceeded developer limit configuration -</message> <message>Is Developer Suspended - true</message> </messages> </error> ``` | [Developer Suspended](https://docs.apigee.com/api-platform/troubleshoot/monetization/troubleshooting-monetization-errors#developersuspended) |
| *You may not observe any error messages, but you will see issues as explained in the [Symptom](https://docs.apigee.com/api-platform/troubleshoot/monetization/troubleshooting-monetization-errors#monetizationsetupissues) section in [Monetization setup issues](https://docs.apigee.com/api-platform/troubleshoot/monetization/troubleshooting-monetization-errors#monetizationsetupissues).* | [Monetization setup issues](https://docs.apigee.com/api-platform/troubleshoot/monetization/troubleshooting-monetization-errors#monetizationsetupissues) |

## Edge Router problems

The Edge Router is implemented with NGINX. During the Edge upgrade process, or when changing
the configuration of the Router, you might see NGINX configuration errors. The following topic
will help you address such problems.

| Error message or description | Playbook |
|---|---|
| *You will not see any error messages. However, you might not be able to execute your API proxies because of the bad config files.* | [Bad Config Files](https://docs.apigee.com/api-platform/troubleshoot/nginx/bad-config-files) |
| `429 Too Many Requests: Tuning Nginx Router connection limits` | [429 Too Many Requests](https://docs.apigee.com/api-platform/troubleshoot/nginx/429-too-many-requests) |

## OpenLDAP problems

The following topics will help you troubleshoot and fix common OpenLDAP problems.

| Error message or description | Playbook |
|---|---|
| `Unknown username and password combination.` | [SMTP is disabled and users need to reset password](https://docs.apigee.com/api-platform/troubleshoot/ldap/troubleshooting-openldap-problems#smtpisdisabledandusersneedtoresetpassword) |
| *No errors appear, the Edge UI simply does not show the list of users that should have been replicated across all OpenLDAP servers.* | [LDAP is not replicating.](https://docs.apigee.com/api-platform/troubleshoot/ldap/troubleshooting-openldap-problems#ldapisnotreplicating) |
| `SLAPD Dead But Pid File Exists` | [Unable to start OpenLDAP](https://docs.apigee.com/api-platform/troubleshoot/ldap/troubleshooting-openldap-problems#unabletostartopenldap) |
| `Unknown username and password combination.` | [OpenLDAP data corruption](https://docs.apigee.com/api-platform/troubleshoot/ldap/troubleshooting-openldap-problems#openldapdatacorruption) |

## Runtime errors

The following topics will help you troubleshoot and fix common runtime problems.

| Error message or description | Playbook |
|---|---|
| ` HTTP/1.1 500 Internal Server Error ` OR ``` { "fault":{ "detail":{ "errorcode":"steps.servicecallout.ExecutionFailed" }, "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed. Reason: ResponseCode 400 is treated as error" } } ``` | [500 Internal Server Error](https://docs.apigee.com/api-platform/troubleshoot/runtime/500-internal-server-error-0) |
| ` HTTP/1.1 502 Bad Gateway ` OR ``` { "fault": { "faultstring": "Unexpected EOF at target", "detail": { "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget" } } } ``` | [502 Bad Gateway](https://docs.apigee.com/api-platform/troubleshoot/runtime/502-bad-gateway) |
| ` HTTP/1.1 503 Service Unavailable ` OR ` HTTP/1.1 503 Service Unavailable: Back-end server is at capacity ` OR ``` { "fault": { "faultstring": "The Service is temporarily unavailable", "detail": { "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable" } } } ``` | [503 Service Unavailable](https://docs.apigee.com/api-platform/troubleshoot/runtime/503-service-unavailable) |
| ` HTTP/1.1 503 Service Unavailable ` OR ` Received fatal alert: handshake_failure ` | [SSL Handshake Failures](https://docs.apigee.com/api-platform/troubleshoot/runtime/ssl-handshake-failures) |
| ` HTTP/1.1 503 Service Unavailable ` OR ``` { "fault": { "faultstring":"The Service is temporarily unavailable", "detail":{ "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable" } } } ``` | [SSL Handshake Failures - Bad Client Certificate](https://docs.apigee.com/api-platform/troubleshoot/runtime/ssl-handshake-failure-bad-client-cert) |
| ` HTTP/1.1 504 Gateway Timeout ` OR ``` { "fault": { "faultstring": "Gateway Timeout", "detail": { "errorcode": "messaging.adaptors.http.flow.GatewayTimeout" } } } ``` | [504 Gateway Timeout](https://docs.apigee.com/api-platform/troubleshoot/runtime/504-gateway-timeout) |

## Zookeeper problems

The following topics will help you troubleshoot and fix common Zookeeper problems.

| Error message or 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 ` OR ` org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss ` OR The Edge UI may display this error: ` Error Fetching Deployments Error while checking path existence for path: path ` | [Zookeeper Connection Loss Errors](https://docs.apigee.com/api-platform/troubleshoot/zookeeper/zookeeper-connection-loss-errors) |
| Data related issues, commonly referred to as wiring issues, can manifest as one of several issues. See [Zookeeper Data Issues](https://docs.apigee.com/api-platform/troubleshoot/zookeeper/zookeeper-data-issues) for details. | [Zookeeper Data Issues](https://docs.apigee.com/api-platform/troubleshoot/zookeeper/zookeeper-data-issues) |
| ` + apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] ` | [Unable to Start Zookeeper](https://docs.apigee.com/api-platform/troubleshoot/zookeeper/unable-start-zookeeper) |

## Diagnostic tools and logs

These topics describe tools and logs that you can use to help diagnose certain kinds of
problems that you may encounter when using Apigee Edge.

- [TCP/IP
  packet sniffer (tcpdump) utility](https://docs.apigee.com/api-platform/troubleshoot/diagnostic-tools-and-logs#tcpippacketsniffertcpdumputility)  
  The tcpdump tool is a command-line packet sniffer tool that allows you to capture or filter TCP/IP packets that are received or transferred over a network.
- [Heap
  dumps](https://docs.apigee.com/api-platform/troubleshoot/diagnostic-tools-and-logs#heapdumps)  
  Heap dumps are a snapshot of the memory of a Java process. They contain the information about the Java objects and classes in the heap at the moment the heap dump is collected.
- [Thread
  dumps](https://docs.apigee.com/api-platform/troubleshoot/diagnostic-tools-and-logs#threaddumps)  
  A thread dump is a snapshot of the state of all the threads of a running Java process. The state of each thread is presented with the contents of its stack, referred to as a stack trace.