503 Service Unavailable

跟踪工具

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

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

   

NGINX 访问日志

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

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

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

   显示 503 错误的示例条目

   

跟踪工具

如需使用“跟踪”工具进行诊断，请执行以下操作：

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

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

   
6. 如果您发现 error.cause 显示 Host not reachable（无法访问主机），则该错误可能是下列原因之一： <ph type="x-smartling-placeholder">
   </ph>
   • 目标服务器/目标端点配置中指定的主机名不正确，或者包含多余的空格或特殊字符。
     
     例如，主机名中有一个多余的空格，如下所示：
     

     "demo-target.apigee.net "
                       

   • 在 API 代理中使用 AssignMessage 覆盖 target.url 变量的主机名，或者 JavaScript 政策不正确或包含空格或任何其他不需要的特殊字符。
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. 如果您看到以下警告/错误消息，则表示消息处理器无法解析主机名。由于此邮件将延后，您可能看不到此消息 警告消息。

   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. 然后，您可能会看到一条消息，提示消息处理器出现故障，但显示“主机无法访问”异常。有时，错误消息会显示主机名：

   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 错误： <ph type="x-smartling-placeholder">
   </ph>
   • 目标服务器/目标端点配置中指定的主机名不正确，或者包含多余的空格或特殊字符。
     
     例如，主机名“demo-target.apigee.net”中有多余的空格。

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

   • API 代理中的 target.url 变量使用 AssignMessage 或 JavaScript 政策覆盖的主机名不正确，或者包含空格或任何其他不需要的特殊字符。
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 服务不可用错误 或由后端服务器发送，则问题 southbound（即消息处理器和后端之间） 服务器）。
3. 如果您没有获得特定 API 调用的跟踪，那么问题就在于 northbound 在客户端应用和路由器之间。

API 监控

借助 API Monitoring，您可以快速分离问题领域，以诊断错误、性能和延迟问题及其来源。 例如开发者应用、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. 如果不是，则问题出在北向连接上（ 客户端应用和路由器）。