OpenSearch Dashboards のトラブルシューティング

ダッシュボード (HTTP OpenSearch Dashboards server is not ready yet 503 準備中エラー) が表示され、ロードは完了しません。ダッシュボードには、起動が完了していないたびにこのページが表示されます。短いバージョンは、再起動、アップグレード、またはブルー/グリーンデプロイ時に正常であり、単独でクリアされます。問題が解決しない場合は、問題として扱います。原因を絞り込むには、ドメインのクラスターの状態と、設定の変更またはアップグレードが進行中かどうかを確認します。

ダッシュボードは、すべてのコアサービスが初期化を完了するまで「サーバーはまだ準備ができていません」を報告します。そのため、起動時とブルー/グリーンデプロイ時にメッセージの一時的なバージョンが予期されます。グリーンクラスターで存続する場合、最も一般的な原因は、OpenSearch Dashboards インデックスの移行がブロックされていることです。起動時に、Dashboards は保存されたオブジェクトをエイリアスの背後にある新しいインデックスに移行し、その移行を完了できない場合、Dashboards の準備は完了しません。ブロックされた移行の一般的なトリガー:

ドメインを現在のサービスソフトウェアバージョンに保持し、アップグレードの前にスナップショットを作成します。本番稼働用モニタリングに Dashboards を使用する場合は、一元化された を検討してください。これはAmazon OpenSearch Service での OpenSearch UI の使用、単一のドメインのドメインごとの OpenSearch Dashboards インデックス移行には関連付けられていません。

ダッシュボードはロードに失敗し、次のようなメッセージが表示されます。

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。ダッシュボードが一括、mget、および検索オペレーションを実行trueできるように、このオプションを に設定します。

ドメインの高度なオプションtrueで rest.action.multi.allow_explicit_indexに戻します。これは、コンソール (ドメインを開き、高度なクラスター設定を編集および更新する) または コマンドラインインターフェイス (AWS CLI) AWS で、独自の AWS 認証情報を使用して行う管理プレーンの変更です。

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

詳細オプションを変更すると、ブルー/グリーンデプロイがトリガーされるため、変更の適用には数分かかります。クラスターの高度な設定の詳細については、「」を参照してください高度なクラスター設定。

リソースベースのポリシーを使用してインデックスアクセスを制限するfalse場合を除き、 rest.action.multi.allow_explicit_indexを に設定しないでください。デフォルト (true) のままにすると、Dashboards は動作し続けます。

ダッシュボードは、特に大きなダッシュボードを開いたり、保存されたオブジェクトを多数ロードしたりすると、再起動、クラッシュ、または負荷がかかっても応答しなくなります。

Dashboards プロセスで使用可能なメモリが枯渇しました。多くの場合、保存されたオブジェクトのロードが多すぎたり、重いダッシュボードをレンダリングしたりします。

Dashboards がメモリ不足になる前にこれを検出するには、OpenSearchDashboardsHeapUtilizationCloudWatch メトリクスを監視します。一貫して 80% を超える場合は、より大きなインスタンスタイプにスケールします。Dashboards の使用に合わせてインスタンスタイプを適切なサイズに調整し、ダッシュボードを無駄に保ち、必要savedObjects:listingLimit以上に増加しないようにします。

リクエストペイロードが Dashboards ペイロード制限 (デフォルトserver.maxPayloadBytesは 1 MB/1,048,576 バイト) を超えているため、特定の Dashboards ページはロードに失敗します。

非常に多数のインデックスまたはフィールドに一致するインデックスパターンは、ペイロード制限を超えるリクエストを生成します。

リクエストがペイロード制限内に収まるように、インデックスパターンを実際に使用するインデックスとフィールドの範囲に保ちます。

ダッシュボードは、エンジンのバージョンアップグレードブルー/グリーンデプロイのほとんどの期間中は使用できません。これは障害ではなく想定される動作であり、アップグレードが完了すると解決されます。

ダッシュボードは、古い環境と新しい環境間のバージョンチェックの競合状態を避けるため、ほとんどのバージョンアップグレードではオフラインのままになります。

アップグレードが完了するまで待ちます。ダッシュボードが自動的に再び利用可能になります。バージョンアップグレードは、計画された Dashboards メンテナンスウィンドウとして扱い、ビジネスクリティカルな時間外にスケジュールします。設定の変更の詳細については、「」を参照してくださいAmazon OpenSearch Service で設定変更を行う。

トラフィックが少ない時間帯にアップグレードをスケジュールします。単一のドメインのアップグレードウィンドウに関連しない Dashboards の可用性が必要な場合は、一元化された を検討してくださいAmazon OpenSearch Service での OpenSearch UI の使用。

エンジンバージョンアップグレードを開始する (またはアップグレード資格チェックを実行する) と、アップグレードが始まる前にアップグレード前のチェックで失敗します。検証通知には、互換性のないインデックスが 1 つ以上一覧表示され、OpenSearch Dashboards インデックスに特に名前を付けることができます。これは通常、ドメインに OpenSearch Dashboards インデックスを含む OpenSearch 1.3、Elasticsearch 7.10 以前で作成されたインデックスがまだあるときに、OpenSearch 3.x にアップグレードするときに発生します。(OpenSearch 1.3 または 2.x からのアップグレードは、最初に OpenSearch 2.19 に移動し、次に OpenSearch 3.x に移動する必要があります）。

OpenSearch は直前のメジャーバージョンからのみインデックスを読み取ることができるため、OpenSearch 3.x は OpenSearch 1.3、Elasticsearch 7.10 以前で作成されたインデックスをサポートしていません。アップグレード前チェックはアップグレードをブロックし、これらのインデックスを意図的に一覧表示するため、データが失われることはありません。メジャーバージョンアップグレードの前に、古いインデックスのインデックスを再作成または削除する必要があります。このサービスはインデックスを自動的に再作成しません。OpenSearch Dashboards インデックスは同じルールに従います。

古いインデックスを再インデックス化または廃止して、複数のメジャーバージョンにまたがらないようにします。複数のアップグレードに残されたインデックスは最終的にブロックされます。アップグレードの前に手動スナップショットを作成し、OpenSearch Dashboards で保存されたオブジェクトを定期的にバックアップとしてエクスポートします。

単一のユーザーまたはブラウザには、空白のページ、空白のレポート、または を読み取る赤いバナーが表示されますがOpenSearch Dashboards did not load properly. Check the server output for more information.、他のユーザーは影響を受けません。プライベート (シークレット) ウィンドウまたは別のブラウザで を再生成して確認します。

古いブラウザキャッシュでは、特にサービスソフトウェアの更新後やレポート機能を使用した後に、この問題が発生します。

サービスソフトウェアの更新後にブラウザキャッシュをクリアし、サポートされているup-to-dateブラウザを使用します。