503 服务不可用 - NoActiveTarget

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

视频

如需详细了解 503 错误，请观看以下视频：

问题

对于 API 代理请求，客户端应用收到 HTTP 响应状态代码 503 以及消息 Service Disabled 和错误代码 NoActiveTarget。

错误消息

您将看到以下错误响应：

HTTP/1.1 503 Service Unavailable
  

您会在 HTTP 响应中看到以下错误消息：

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

可能的原因

当您在 API 代理的目标端点配置中使用一个或多个目标服务器时，通常观察到 HTTP 响应 503 Service Disabled 以及错误代码 NoActiveTarget。

下表列出了导致出现 503 Service Disallow 和错误代码 NoActiveTarget 响应的可能原因：

原因：目标服务器已停用

如果目标端点配置中指定的所有目标服务器都已停用，则您会收到 503 Service Available 响应，错误代码为 NoActiveTarget.

诊断

1. 通过以下任一方式确定出现故障的 API 代理的特定目标端点配置中使用的目标服务器的名称：
1. 如果只有一个目标端点，则检查该特定目标端点。
2. 如果有多个目标端点，而您不确定哪个端点已停用目标服务器，请按照以下步骤操作：
1. 启用跟踪会话，发出 API 调用，并重现问题 - 503 Service available（503 服务不可用）。
2. 从跟踪记录中，转到 Target Request Flow Started，并确定目标端点的名称，如下所示：



2. 确定目标端点后，请从目标端点配置中获取所用的目标服务器名称，如下例所示：

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   在上面的示例中，有一个名为 demo-target 的目标服务器。

3. 通过 Edge 界面或 Edge API 调用获取目标端点中使用的每个目标服务器的定义。

   Edge 界面

   如需使用 Edge 界面获取定义，请执行以下操作：

   1. 依次前往管理 > 环境 > 目标服务器。
   2. 选择您要查看失败情况的具体环境。
   3. 搜索具体的目标服务器名称，以获取目标服务器定义。

      例如，输入目标服务器名称 demo-target，您将看到如下所示的定义：

      

      请注意，此处的目标服务器 demo-target 有一个主机别名，端口 # 启用了 SSL。 不过，目标服务器本身已遭停用 ，已启用元素显示为灰色。

   Edge API

   如需使用 Edge API 获取定义，请执行以下操作：

   使用 Get TargetServer API 获取目标服务器定义。

   目标服务器定义输出

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   Apigee API 输出显示目标服务器 demo-target 已停用，因为 IsEnabled 元素已设置为 false。

   由于目标服务器已停用，消息处理器将立即发送包含错误代码 NoActiveTarget 的 503 Service Available 作为对客户端的响应。

分辨率

确保 API 代理的目标端点配置中使用的特定目标服务器始终处于启用状态。

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

如果问题仍然存在，请转到必须收集诊断信息。

使用 API 监控功能诊断问题

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

通过一个示例场景演示了如何使用 API Monitoring 排查 API 的 5xx 问题。例如，您可能需要设置提醒，以便在 messaging.adaptors.http.flow.NoActiveTargets 故障数量超过特定阈值时收到通知。

必须收集的诊断信息

如果按照上述说明操作后，问题仍然存在，请收集以下诊断信息。请与 Apigee 支持团队联系并分享相关信息：

1. 如果您是公有云用户，请提供以下信息：
1. 组织名称
2. 环境名称
3. API 代理名称
4. 完成 curl 命令以重现错误
5. 跟踪文件，包含带有 503 Service Available 且错误代码 NoActiveTarget 的请求
2. 如果您是 Private Cloud 用户，请提供以下信息：
   1. 观察到了完整的错误消息
   2. 环境名称
   3. API 代理软件包
   4. 跟踪文件，包含带有 503 Service Available 且错误代码 NoActiveTarget 的请求
   5. NGINX 访问日志

      (/opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log)

   6. 消息处理器日志

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)