您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
本页面包含一些链接,指向在使用 Apigee Edge 时可能遇到的错误和其他问题问题排查策略方案。每个问题排查手册都介绍了如何诊断和解决每种类型的问题。
数据分析问题
以下主题介绍了如何排查 Analytics 数据未显示在 Analytics 信息中心或自定义报告中的问题。
错误消息或说明 | Playbook |
---|---|
The report timed out: Try again with a smaller
date range or a larger aggregation interval. |
或者: |
除非 Postgres 服务器上的磁盘空间填满,否则您可能不会看到任何错误消息。 | Postgres 服务器耗尽磁盘空间 |
未观察到错误。 | 自定义变量对 Google Analytics(分析)自定义报告不可见 |
No traffic in the selected date range |
分析信息中心未显示数据 |
该主题介绍了如何执行经常请求的任务。 | 在分析群组中添加和删除分析组件 |
Could not get data for path |
配置了多个 axgroup 时,自定义维度未显示 |
部署错误
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 |
为路径提取子项时出错 |
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> |
开发者已被暂停 |
您可能不会看到任何错误消息,但会看到 创收设置问题的 问题部分所述的问题。 | 创收设置问题 |
边缘路由器问题
边缘路由器通过 NGINX 实现。在边缘升级过程中或更改路由器配置时,您可能会看到 NGINX 配置错误。以下主题将帮助您解决此类问题。
错误消息或说明 | Playbook |
---|---|
您不会看到任何错误消息。但是,由于配置文件有问题,您可能无法执行 API 代理。 | 配置文件错误 |
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
或
{ "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 Service Available(服务不可用) |
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 连接丢失错误 |
数据相关问题(通常称为布线问题)可以表现为多种问题之一。请参阅 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 进程的所有线程的状态快照。每个线程的状态都会与其堆栈的内容一起显示,称为堆栈轨迹。