您正在查看 Apigee 和 Apigee Hybrid 文档。
查看 Apigee Edge 文档。
问题排查既是艺术，也是科学。Apigee 技术支持团队一直致力于揭开这一艺术的神秘面纱，并揭示问题识别和解决方法背后的科学原理。
什么是策略方案？
Apigee 问题排查策略方案是与 Apigee 技术支持团队合作开发的，旨在快速有效地解决使用 Apigee 产品时可能会遇到的错误或其他问题。
要查找问题排查策略方案，您可以尝试使用本页面顶部的搜索框搜索具体的错误消息，也可以使用左侧的目录导航至策略方案库。
受众
问题排查策略方案适用于对 Apigee 及其架构有大致了解，并对政策和分析等基本概念有一定了解的读者。
某些问题只能由 Apigee Hybrid 用户诊断和解决，并且可能需要了解内部组件，例如 Cassandra 和 Postgres 数据存储区、消息处理器和路由器。
如果您使用的是 Apigee，我们会明确说明何时可以执行指定的问题排查步骤，何时需要联系 Apigee 支持团队获取帮助。
策略方案
下表介绍了当前的策略方案：
Cassandra |
||
|---|---|---|
| 策略方案/问题说明 | 错误消息 | 策略方案适用对象 |
| Cassandra 数据复制失败 |
在多区域扩展期间复制数据时，CassandraDataReplication 状态可能会显示错误状态，并且数据复制可能会失败。 |
仅限 Apigee Hybrid 用户 |
| Cassandra pod 未在次要区域中启动 |
Cassandra pod 无法在多地区 Apigee 混合设置中的一个地区启动。
您可能会在 Cassandra pod 日志中看到 node already exists 错误消息，或在 Cassandra pod 状态中看到 FailedPreStopHook 警告。 |
仅限 Apigee Hybrid 用户 |
| Cassandra 问题排查指南 |
使用 kubectl 查看 Pod 状态时，您会看到一个或多个 Cassandra Pod 卡在 Pending 状态。Pending 状态表示 Kubernetes 无法调度节点上的 Pod：无法创建 Pod。 |
仅限 Apigee Hybrid 用户 |
部署 |
||
|---|---|---|
| 策略方案/问题说明 | 错误消息 | 策略方案适用对象 |
| API 代理部署失败，没有活动运行时 pod 警告 | 在 API 代理 页面上，没有活动的运行时 pod (No active runtime pods) 警告显示在错误消息 Deployment issues on ENVIRONMENT: REVISION_NUMBER 旁边的 详细信息对话框中。 | 仅限 Apigee Hybrid 用户 |
Ingressgateway |
||
|---|---|---|
| 策略方案/问题说明 | 错误消息 | 策略方案适用对象 |
| API 调用失败并显示超时错误 |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
仅限 Apigee Hybrid 用户 |
| API 调用失败并显示 TLS 错误 |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
仅限 Apigee Hybrid 用户 |
管理/界面 |
||
|---|---|---|
| 策略方案/问题说明 | 错误消息 | 策略方案适用对象 |
| 在 Hybrid 界面中或通过 Management API 发现实体具有不一致数据或无数据 | 在这种情况下，系统不显示错误消息。 | 仅限 Apigee Hybrid 用户 |
其他 |
||
|---|---|---|
| 策略方案/问题说明 | 错误消息 | 策略方案适用对象 |
| 排空节点时扩展 Istio 属性副本数量 | 排空 Istio Pod 时，某些节点可能由于副本数量为 1 而没有排空，而需要使用 3 个或更多副本。为避免出现这种情况，您应将每个属性的最小副本数量至少设置为 3。 | 仅限 Apigee Hybrid 用户 |
| 消息处理器问题排查指南 |
一个或多个 apigee-runtime Pod 未处于 Ready 状态。
使用 kubectl 描述失败的 apigee-runtime Pod 时，您会看到以下错误：Readiness probe failed: HTTP probe failed with statuscode: 500 |
仅限 Apigee Hybrid 用户 |
| 打印构建信息 |
buildinfo API 返回有关运行时组件当前构建的信息。如果您需要联系支持团队，这些信息可能会很有用。 |
仅限 Apigee Hybrid 用户 |
| StreamingPull 显示 100% 错误率 |
如果您在指标信息中心内看到 google.pubsub.vl.Subscriber.StreamingPull 方法失败并出现 100% 错误，您可以放心地忽略此问题。这是预期行为。 |
仅限 Apigee Hybrid 用户 |