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-codemessaging.adaptors.http.flow.ServiceAvailable 出现任何 503 错误，请记下一个或多个此类请求的消息 ID，如以下示例所示：

   显示 503 错误的示例条目

   

跟踪工具

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

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

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

   
6. 如果您发现 error.cause 显示无法访问主机，那么导致此错误的可能原因包括：
   • 目标服务器/目标端点配置中指定的主机名不正确，或者包含多余的空格或特殊字符。
     
     例如，主机名中有一个多余的空格，如下所示：
     

     "demo-target.apigee.net "
                       

   • API 代理中的 target.url 变量使用 AssignmentMessage 或 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. 如果您看到以下警告/错误消息，则说明消息处理器无法解析主机名。由于消息将被延后，因此您可能看不到有些消息 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. 然后，您可能会看到一条消息，提示消息处理器失败，并显示“无法连接主机”异常消息。有时，错误消息中会包含主机名：

   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 代理中的 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 服务不可用”错误发生在目标请求流期间或由后端服务器发送，则表示问题为南向（即消息处理器和后端服务器之间）。
3. 如果您没有获取特定 API 调用的跟踪记录，则说明客户端应用与路由器之间的问题属于北向问题。

API 监控

借助 API 监控功能，您可以快速隔离有问题的方面，从而诊断错误、性能和延迟问题及其来源，例如开发者应用、API 代理、后端目标或 API 平台。

通过一个示例场景演示了如何使用 API Monitoring 排查 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. 如果不能，则表示问题发生在北向连接（客户端应用与路由器之间的连接）上。