故障排除 OpenSearch 仪表板

仪表板显示OpenSearch Dashboards server is not ready yet（HTTP 503 未就绪错误），但无法完成加载。每当该页面尚未完成启动时，仪表板就会显示该页面。在重启、升级或 blue/green 部署期间，简短版本是正常的，会自行清除。当问题持续存在时，将其视为问题。要缩小原因范围，请检查域的集群运行状况以及配置更改或升级是否正在进行中：

在服务器的所有核心服务完成初始化之前，仪表板会报告 “服务器尚未准备就绪”，这就是为什么在启动和 blue/green 部署期间需要消息的临时版本的原因。当它在绿色集群中持续存在时，最常见的原因是 OpenSearch 仪表板索引的迁移被阻止：启动时，仪表板会将其保存的对象迁移到别名后面的新索引中，如果迁移无法完成，仪表板将永远无法准备就绪。受阻迁移的常见触发因素：

将您的域名保持在最新的服务软件版本上，并在每次升级之前拍摄快照。如果您依赖仪表板进行生产监控，请考虑集中式在 Amazon OpenSearch 服务中使用 OpenSearch 用户界面，它与单个域的每个域的 OpenSearch 仪表板索引迁移无关。

仪表板无法加载并显示类似于以下内容的消息：

Kibana must be able to specify the index within Elasticsearch multi-requests (rest.action.multi.allow_explicit_index=true).

rest.action.multi.allow_explicit_index高级群集选项设置为false。将此选项设置为，true以便仪表板可以执行其批量、mget 和 msearch 操作。

在域名的高级选项true中rest.action.multi.allow_explicit_index重新设置为。这是您使用自己的 AWS 凭据在控制台（打开域，选择编辑并更新高级集群设置）或使用 AWS 命令行界面 (CL AWS I) 进行的管理平面更改：

aws opensearch update-domain-config \
  --domain-name my-domain \
  --advanced-options rest.action.multi.allow_explicit_index=true

更改高级选项会触发 blue/green 部署，因此更改需要几分钟才能生效。有关高级集群设置的更多信息，请参阅高级集群设置。

false除非您打算通过基于资源的策略限制索引访问权限，否则不要将其设置为rest.action.multi.allow_explicit_index。将其保留为默认值 (true) 可保持仪表板正常运行。

仪表板在负载下会重新启动、崩溃或无响应，尤其是在打开大型仪表板或加载许多已保存对象时。

仪表板进程耗尽了其可用内存，这通常是由于加载了太多保存的对象或渲染了繁重的仪表板。

要在 Dashboards 内存耗尽之前发现这一点，请注意OpenSearchDashboardsHeapUtilization CloudWatch 指标；如果指标持续超过 80%，请扩展到更大的实例类型。 Right-size 您的仪表板使用实例类型，保持仪表板精简，避免savedObjects:listingLimit超出您的需求。

某些仪表板页面无法加载，因为请求负载超过了仪表板有效负载限制（server.maxPayloadBytes默认为 1 MB /1,048,576 字节）。

与大量索引或字段匹配的索引模式生成的请求大于有效负载限制。

将索引模式的范围限制在您实际使用的索引和字段范围内，以便请求保持在有效负载限制之内。

在引擎版本升级部署 blue/green 的大部分时间里，仪表板都不可用。这是预期行为，不是故障，升级完成后它会自行解决。

在版本升级的大部分时间里，仪表板都保持离线状态，以避免新旧环境之间的版本检查竞争条件。

等待升级完成；仪表板将自动恢复可用。将版本升级视为计划的仪表板维护窗口，并安排在关键业务时间以外的时间进行升级。有关配置更改的更多信息，请参阅在 Amazon OpenSearch 服务中进行配置更改。

在流量较低的时段安排升级。如果您需要与单个域的升级窗口无关的仪表板可用性，请考虑集中式在 Amazon OpenSearch 服务中使用 OpenSearch 用户界面。

在任何升级开始之前，您启动了引擎版本升级（或运行升级资格检查），但升级前检查失败。验证通知列出了一个或多个不兼容的索引，并且可以专门命名 OpenSearch 仪表板索引。当你升级到 OpenSearch 3.x 时，通常会发生这种情况，而域名仍有在 OpenSearch 1.3、Elasticsearch 7.10 或更早版本中创建的索引，包括仪表板索引。 OpenSearch （从 OpenSearch 1.3 或 2.x 升级必须先升级到 OpenSearch 2.19，然后再升级到 OpenSearch 3.x。）

OpenSearch 只能读取之前的主版本中的索引，因此 OpenSearch 3.x 不支持在 OpenSearch 1.3、Elasticsearch 7.10 或更早版本中创建的索引。升级前检查会阻止升级并故意列出这些索引，这样您就不会丢失任何数据。在主版本升级之前，您必须重新索引或删除较旧的索引；该服务不会自动为它们重新编制索引。 OpenSearch 仪表板索引遵循相同的规则。

重新编制索引或停用旧索引，这样它们就不会跨越多个主要版本；在多次升级中留下的索引最终将阻止一个主要版本。每次升级前都要手动拍摄快照，并定期导出 OpenSearch 仪表板上保存的对象作为备份。

单个用户或浏览器会看到空白页面、空白报告或显示的红色横幅OpenSearch Dashboards did not load properly. Check the server output for more information.，而其他用户则不受影响。通过在私人（隐身）窗口或其他浏览器中复制来确认。

陈旧的浏览器缓存会导致此问题，尤其是在服务软件更新之后或使用报告功能时。

服务软件更新后清除浏览器缓存，并使用支持的最新浏览器。