503 Service Unavailable

Trace 工具

如需使用跟踪工具确定失败请求的消息 ID，请执行以下操作：

1. 如果问题仍然存在，请为受影响的 API 启用跟踪会话。
2. 进行 API 调用并重现问题 - 503 服务不可用，错误代码为 messaging.adaptors.http.flow.ServiceUnavailable.
3. 选择其中一个失败的请求。
4. 前往 AX 阶段，然后在阶段详情部分中向下滚动，确定请求的消息 ID (X-Apigee.Message-ID)，如下图所示。

   

NGINX 访问日志

如需使用 NGINX 访问日志确定失败请求的消息 ID，请执行以下操作：

您还可以参考 NGINX 访问日志来确定 503 错误的 message ID。 如果过去曾发生过该问题或者该问题间歇性发生，并且您无法在界面中捕获跟踪记录，则此功能特别有用。您可以按照以下步骤从 NGINX 访问日志中确定此信息：

1. 检查 NGINX 访问日志：(/opt/apigee/var/log/edge-router/nginx/ <org>~ <env>.<port#>_access_log)
2. 搜索特定 API 代理在特定时间段内（如果问题发生在过去）是否有任何 503 错误，或者是否有任何请求仍然失败并返回 503 错误。
3. 如果存在任何 503 错误，且包含 X-Apigee-fault-code messaging.adaptors.http.flow.ServiceUnavailable 消息，请记下此类请求的消息 ID，如下例所示：

   显示 503 错误的条目示例

   

Trace 工具

如需使用 Trace 工具进行诊断，请执行以下操作：

1. 如果问题仍然存在，请为受影响的 API 启用跟踪会话。
2. 进行 API 调用并重现问题 - 503 服务不可用，错误代码为 messaging.adaptors.http.flow.ServiceUnavailable.
3. 选择其中一个失败的请求。
4. 浏览轨迹的各个阶段，找到发生故障的位置。
5. 选择出现错误的 FlowInfo。您可以在 error.cause 字段中找到更多信息，该字段可以告知您失败的原因，如以下示例所示：

   显示跟踪记录中 error.cause 的示例请求

   
6. 如果您发现 error.cause 显示 Host not reachable，则该错误很可能是由以下原因之一造成的：
   • 目标服务器/目标端点配置中指定的主机名不正确或包含不需要的空格或特殊字符。
     
     例如，主机名中包含不必要的空格，如下所示：
     

     "demo-target.apigee.net "
                       

   • API 代理中使用 AssignMessage 或 JavaScript 政策通过 target.url 变量覆盖的主机名不正确，或者包含空格或任何其他不需要的特殊字符。
7. 检查目标端点配置和/或目标服务器定义，看看目标服务器主机名是否不正确或包含任何不需要的空格或特殊字符。
8. 如果目标服务器主机是动态创建的，请检查用于创建它的相应政策（例如 AssignMessage/JavaScript 政策）。检查目标服务器主机名是否不正确，或者是否包含任何不需要的空格或特殊字符。
9. 确定目标服务器主机名后，对该主机名运行 nslookup/dig 命令，以查看是否可以解析该主机名。

   例如，对包含不必要空格的主机名运行 nslookup 命令会返回以下输出：

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN

10. 如果操作系统命令 nslookup 也无法解析主机名，则此问题的原因是目标服务器所用的主机名不正确。

    前往解决方案。

消息处理器日志

如需使用消息处理器日志进行诊断，请执行以下操作：

1. 确定失败请求的消息 ID。
2. 在消息处理器日志中搜索消息 ID。(/opt/apigee/var/log/edge-message-processor/logs/system.log)
3. 如果您看到以下警告/错误消息，则表示消息处理器无法解析主机名。由于消息将被延后，因此您可能不会看到所有消息 ID/请求的此警告消息。

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 WARN S.HTTPCLIENTSERVICE - DNSCache$2.failed() : Failed to resolve hostname www.somehost.com . Reason mocktarget.apigee.net : Name or service not known. This log message will snooze for 2 hours
       

4. 随后，消息处理器会因无法访问目标服务器主机而从 DNS 缓存中移除相应地址，并显示一条警告消息。

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid> NIOThread@0 WARN  c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.addressNotReachable() : The last address has been removed from Address list null refreshing
       

5. 然后，您可能会看到一条消息，其中显示消息处理器因“Host not reachable”（主机无法访问）异常而失败。有时，错误消息中会显示主机名：

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

6. 有时，由于主机名无法解析或无法访问，系统可能会将其显示为 null，如下所示：

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

7. Host not reachable 错误通常会在以下情况下发生：
   • 目标服务器/目标端点配置中指定的主机名不正确或包含不需要的空格或特殊字符。
     
     例如，在以下错误消息中，主机名“demo-target.apigee.net ”中存在不必要的空格：

     NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception
             

   • API 代理中使用 AssignMessage 或 JavaScript 政策通过 target.url 变量覆盖的主机名不正确，或者包含空格或任何其他不需要的特殊字符。
8. 使用以下任一方法确定消息处理器尝试与之通信的目标服务器主机名：
1. 仔细检查包含 Host not reachable 的错误消息。
2. 如果错误消息显示了主机名，请复制该主机名，包括任何空格或特殊字符。
3. 如果错误消息显示主机名为 null，如下面的错误消息所示，

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
           

1. 通过检查失败的 API 代理中使用的目标服务器定义来确定主机名。
2. 如果目标服务器主机是动态创建的，请检查用于创建它的相应政策（例如 AssignMessage/JavaScript 政策）。
9. 确定目标服务器主机名后，对该主机名运行 nslookup/dig 命令，并检查是否可以解析该主机名。

   例如，对包含空格的主机名运行 nslookup 命令

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN
         

10. 如果操作系统命令 nslookup 也无法解析主机名，则此问题的原因是用于目标服务器的主机名不正确。

界面轨迹

如需使用界面跟踪记录确定错误发生的位置，请执行以下操作：

1. 如果问题仍然存在，请为受影响的 API 启用界面轨迹。
2. 如果失败的 API 请求的界面轨迹显示 503 Service Unavailable 错误发生在目标请求流程期间或由后端服务器发送，则问题出在南向（即消息处理器和后端服务器之间）。
3. 如果您没有获得特定 API 调用的轨迹，则问题出在客户端应用和路由器之间的北向。

API 监控

借助 API 监控，您可以快速找出问题区域，以诊断错误、性能和延迟时间问题及其来源，例如开发者应用、API 代理、后端目标或 API 平台。

逐步了解示例场景，该场景演示了如何使用 API 监控功能排查 API 的 5xx 问题。 例如，您可能希望设置一个提醒，以便在 messaging.adaptors.http.flow.ServiceUnavailable 故障数量超过特定阈值时收到通知。

NGINX 访问日志

如需使用界面跟踪记录确定错误发生的位置，请执行以下操作：

如果过去曾发生过该问题或者该问题间歇性发生，并且您无法捕获跟踪记录，请执行以下步骤：

1. 检查 NGINX 访问日志 (/opt/apigee/var/log/edge-router/nginx/ org-env.port_access_log)。
2. 搜索特定 API 代理是否存在任何 503 错误。
3. 如果您能确定特定 API 在特定时间出现过任何 503 错误，则说明问题出在出站连接（消息处理器与后端服务器之间）。
4. 如果不是，则问题出在北向连接（客户端应用与路由器之间）。