错误消息参考

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

本页面包含一些链接，点击这些链接即可了解如何排查错误和您可能会遇到的其他问题 会遇到哪些错误每份问题排查手册都介绍了如何诊断和解决 各种问题。

Analytics 问题

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

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

Google Analytics 报告 超时

或者：

报告超时
除非 Postgres 服务器。 Postgres 服务器耗尽磁盘空间
未观察到任何错误。 <ph type="x-smartling-placeholder"></ph> 自定义变量不会在 Google Analytics 自定义报告中显示
No traffic in the selected date range 数据不是 显示在 Google Analytics 信息中心内
本主题介绍了如何执行常见的任务。 在分析群组中添加和删除分析组件
Could not get data for path 如果配置了多个轴组，自定义维度未显示

部署错误

API 代理的部署可能会因各种原因（例如网络连接问题）而失败 边缘服务器之间传输的问题、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 错误 提取 Path 的子节点
Error while accessing datastore;Please retry later 错误 访问 Datastore
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. 或 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>
<ph type="x-smartling-placeholder"></ph> 开发者账号被暂停
您可能看不到任何错误消息，但仍会看到 <ph type="x-smartling-placeholder"></ph> 中的“问题”部分 创收设置问题。 <ph type="x-smartling-placeholder"></ph> 创收设置问题

边缘路由器问题

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

错误消息或说明 Playbook
您不会看到任何错误消息。不过，您可能无法执行自己的 API， 会因为配置文件错误而影响代理。 配置有误 文件

OpenLDAP 问题

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

错误消息或说明 Playbook
Unknown username and password combination. <ph type="x-smartling-placeholder"></ph> SMTP 已停用，且用户需要重置密码
没有显示任何错误，Edge 界面只是不显示 应该复制到的 OpenLDAP 服务器。 <ph type="x-smartling-placeholder"></ph> LDAP 未在复制。
SLAPD Dead But Pid File Exists <ph type="x-smartling-placeholder"></ph> 无法启动 OpenLDAP
Unknown username and password combination. <ph type="x-smartling-placeholder"></ph> OpenLDAP 数据损坏

运行时错误

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

错误消息或说明 Playbook
HTTP/1.1 500 Internal Server Error 或 
{
   "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 或 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 错误 网关
HTTP/1.1 503 Service Unavailable 或 HTTP/1.1 503 Service Unavailable: Back-end server is at capacity 或 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 服务 不可用
HTTP/1.1 503 Service Unavailable 或 Received fatal alert: handshake_failure SSL 握手 失败
HTTP/1.1 503 Service Unavailable 或 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL 握手 失败 - 客户端证书有误
HTTP/1.1 504 Gateway Timeout 或 
{
   "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

或

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

或

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

Error Fetching Deployments Error while checking path existence for path: path 		动物园 连接丢失错误
与数据相关的问题（通常称为布线问题）可能表现为以下某种情况： 几个问题。请参阅 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 进程中所有线程的状态快照。通过 每个线程的状态以其堆栈（称为堆栈）的内容表示 跟踪记录。