错误消息参考

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 info

本页面包含指向问题排查 Playbook 的链接，这些 Playbook 适用于您在使用 Apigee Edge 时可能 遇到的错误和其他问题。每个问题排查 Playbook 都会说明如何诊断和解决 每种类型的问题。

Analytics 问题

以下主题介绍了如何排查 Analytics 数据未显示在 Analytics 信息中心或自定义报告中的情况。

错误消息或说明 Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Analytics 报告 超时

或者：

报告超时
除非 Postgres 服务器上的磁盘空间已完全填满，否则您可能不会看到任何错误消息。 Postgres 服务器磁盘空间不足
未观察到任何错误。 Analytics 自定义报告中看不到自定义变量
No traffic in the selected date range Analytics 信息中心未显示数据
该主题介绍了如何执行一项常见请求的任务。 在 Analytics 组中添加和删除 Analytics 组件
Could not get data for path 配置多个 axgroup 后，自定义维度未显示

部署错误

API 代理的部署可能会因各种原因而失败，例如 Edge 服务器之间的网络连接问题 、Cassandra 数据存储区问题、ZooKeeper 异常以及 API 代理软件包中的错误。本部分提供了一些特定 程序的信息和指南，这些程序可用于排查部署错误。
错误消息或说明 Playbook
Error: Call timed out; either server is down or server is not reachable 超时 错误
Unexpected error Error while fetching children for path 提取路径的子项时出错
Error while accessing datastore;Please retry later 访问数据存储区时出错
Configuration failed, associated contexts = [] 配置失败
Unexpected error occurred while processing the updates, associated contexts = [] 错误 处理更新时出错

开发者门户错误

以下主题可帮助您解决在使用开发者门户时可能遇到的问题。 在尝试解决开发者门户问题之前，请务必先基本了解 开发者门户的工作原理，如开发者 门户问题排查概览中所述。
错误消息或说明 Playbook
An internal error has occurred. Please retry your request. 开发者 门户内部错误
The website encountered an unexpected error. Please try again later. OR There was an error trying to create the App. Please try again later. 开发者 门户通信问题

创收问题

以下主题将帮助您排查和解决常见的创收 问题。

错误消息或说明 Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
开发者被暂停
您可能不会看到任何错误消息，但会看到 创收设置问题中的 症状部分所述的问题。 创收设置问题

Edge 路由器问题

Edge 路由器是使用 NGINX 实现的。在 Edge 升级过程中或更改 路由器的配置时，您可能会看到 NGINX 配置错误。以下主题 将帮助您解决此类问题。

错误消息或说明 Playbook
您不会看到任何错误消息。但是，由于配置文件错误，您可能无法执行 API 代理。 配置文件错误
429 Too Many Requests: Tuning Nginx Router connection limits 429 请求过多

OpenLDAP 问题

以下主题将帮助您排查和解决常见的 OpenLDAP 问题。

错误消息或说明 Playbook
Unknown username and password combination. SMTP 已停用，用户需要重置密码
未显示任何错误，Edge 界面只是未显示应已在所有 OpenLDAP 服务器中复制的用户列表。 LDAP 未复制。
SLAPD Dead But Pid File Exists 无法启动 OpenLDAP
Unknown username and password combination. OpenLDAP 数据损坏

运行时错误

以下主题将帮助您排查和解决常见的运行时问题。

错误消息或说明 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 内部服务器错误
HTTP/1.1 502 Bad Gateway OR 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
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 服务 不可用
HTTP/1.1 503 Service Unavailable OR Received fatal alert: handshake_failure SSL 握手 失败
HTTP/1.1 503 Service Unavailable OR 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL 握手 失败 - 客户端证书无效
HTTP/1.1 504 Gateway Timeout OR 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 网关 超时

Zookeeper 问题

以下主题将帮助您排查和解决常见的 Zookeeper 问题。
错误消息或说明 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

Edge 界面可能会显示以下错误：

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper 连接丢失错误
与数据相关的问题（通常称为连接问题）可能会表现为以下几种问题之一。如需了解详情，请参阅 Zookeeper 数据问题 。 Zookeeper 数据问题
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] 无法 启动 Zookeeper

诊断工具和日志

以下主题介绍了可帮助您诊断在使用 Apigee Edge 时可能遇到的某些类型 问题的工具和日志。

  • TCP/IP 数据包嗅探器 (tcpdump) 实用程序
    tcpdump 工具是一种命令行数据包嗅探器工具，可让您捕获或过滤 通过网络接收或传输的 TCP/IP 数据包。
  • 堆 转储
    堆转储是 Java 进程内存的快照。它们包含收集堆转储时堆中 Java 对象和类的信息。
  • 线程 转储
    线程转储是正在运行的 Java 进程的所有线程状态的快照。每个线程的状态都通过其堆栈的内容（称为堆栈 轨迹 ）呈现。