翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# OpenSearch Dashboards のトラブルシューティング
<a name="dashboards-troubleshooting"></a>

このセクションでは、OpenSearch Dashboards が使用できなくなったり、ロードに失敗したり、予期せず動作したりする可能性がある既知の問題について説明します。各問題には、自分で解決するために実行できるアクションが含まれています。ダッシュボードはドメイン内のホットデータノードで実行され、その状態 (インデックスパターン、視覚化、ダッシュボード) を OpenSearch Dashboards インデックスに保存します。その結果、ほとんどの Dashboards の可用性の問題は、クラスターの状態、ストレージ、OpenSearch Dashboards インデックスの移行、クラスターまたは Dashboards の設定、リソース制限、ドメインのサービスソフトウェアバージョンまでさかのぼります。

各問題は**、症状** (表示される内容と確認方法）、**根本原因**、**緩和方法** (セルフサービスステップ）、**推奨されるアクション** (再発を防ぐ方法) として整理されます。

**注記**  
Dashboards の既知の問題の多くは、新しいサービスソフトウェアリリースですでに解決されています。さらにトラブルシューティングを行う前に、Amazon OpenSearch Service コンソール (OpenSearch Dashboards UI ではなくサービスの AWS コンソール) OpenSearch を開き、**通知**パネルを確認して、利用可能な最新のサービスソフトウェア更新をインストールします。以下のいくつかのセクションでは、これを推奨されるアクションとして示しています。設定の変更またはアップグレードがすでに進行中の場合は、更新をインストールする前に設定の変更またはアップグレードが終了するのを待ちます。

## ダッシュボードが「サーバーはまだ準備ができていません」にスタックしています (HTTP 503 の準備ができていませんエラー)
<a name="dashboards-troubleshooting-not-ready"></a>

症状  
ダッシュボード (HTTP `OpenSearch Dashboards server is not ready yet` 503 準備中エラー) が表示され、ロードは完了しません。ダッシュボードには、起動が完了していないたびにこのページが表示されます。短いバージョンは、再起動、アップグレード、またはブルー/グリーンデプロイ時に正常であり、単独でクリアされます。問題が解決しない場合は、問題として扱います。原因を絞り込むには、ドメインの**クラスターの状態**と、設定の変更またはアップグレードが進行中かどうかを確認します。  
+ 変更またはアップグレードが進行中の場合、メッセージは通常一時的なものです。ドメインが**アクティブ**に戻るのを待ちます。
+ クラスターの状態が赤の場合、クラスターに依存するため、ダッシュボードを起動できません。最初にクラスターの問題を解決します (「」を参照[関連するクラスターとアクセスの問題](#dashboards-troubleshooting-related))。
+ クラスターの状態が緑色の間もメッセージが持続する場合、OpenSearch Dashboards インデックスの移行はブロックされている可能性が高くなります (以下で説明）。

根本原因  
ダッシュボードは、すべてのコアサービスが初期化を完了するまで「サーバーはまだ準備ができていません」を報告します。そのため、起動時とブルー/グリーンデプロイ時にメッセージの一時的なバージョンが予期されます。グリーンクラスターで存続する場合、最も一般的な原因は、OpenSearch Dashboards インデックスの移行がブロックされていることです。起動時に、Dashboards は保存されたオブジェクトをエイリアスの背後にある新しいインデックスに移行し、その移行を完了できない場合、Dashboards の準備は完了しません。ブロックされた移行の一般的なトリガー:  
+ アップグレード後、ブロックされた移行は、次の理由で発生する可能性があります。
  + OpenSearch Dashboards インデックスが以前のバージョンから残っていると、新しいエイリアスが作成されなくなります。
  + Dashboards が既存のインデックスと競合するエイリアスを使用しなかった古いエンジンバージョンからのアップグレード。
  + 新しい (セルフマネージド) Dashboards インスタンスによって書き込まれたドキュメントは、ターゲットバージョンに自動的に移行できません。
+ アップグレードを行わないと、次の理由で移行がブロックされる可能性があります。
  + UI リクエストまたは復元によって作成された破損した OpenSearch Dashboards インデックスは、エイリアスをブロックします。
  + 2 つ以上のバージョニングされた OpenSearch Dashboards インデックスは、同じエイリアスをポイントします。これは、クラスターの状態が緑色であっても `Internal Server Error` (HTTP 500) として表示することもできます。
  + ユーザー単位またはテナント単位のインデックスは、きめ細かなアクセスコントロールまたは Amazon Cognito 認証を使用するドメインのエイリアスなしで作成されました。
  + ドキュメントが壊れているため、保存されたオブジェクトマッピングの変更を適用できません。

緩和方法  

1. 設定変更またはバージョンアップグレードが進行中の場合は、ドメインが**アクティブ**に戻るのを待ちます。多くの場合、メッセージは一時的なもので、それ自体でクリアされます。通常の変更またはアップグレードは数時間以内に完了します。ドメインが**アクティブ**に戻ってから 4 時間以上経ってもダッシュボードが使用できない場合は、永続的な問題として扱います。次のステップに進みます。(ドメインが変更を処理している間は、サービスソフトウェアの更新を開始できません）。

1. クラスターの状態が赤または黄色の場合は、最初にクラスターの問題を解決します (「」を参照[関連するクラスターとアクセスの問題](#dashboards-troubleshooting-related))。ダッシュボードは、異常なクラスターで起動できません。

1. クラスターの状態が緑色の間もメッセージが持続する場合は、 AWS Support が問題をより迅速に解決するのに役立つ読み取り専用の診断を収集し、[AWS サポート](https://aws.amazon.com/premiumsupport/)に連絡して OpenSearch Dashboards インデックスを修復してください。ケースには、次のコマンドの出力を含めます。

   ```
   GET _cat/aliases/.kibana*?v
   GET _cat/indices/.kibana*?v
   ```

   ブロックされた移行の修復は、既にスタックしているドメインの修正です。ソフトウェア更新をインストールしても、既にスタックしているドメインのブロックは解除されません。OpenSearch Dashboards インデックスを自分で削除しないでください。これを削除すると、スナップショットにバックアップされていないすべての保存された視覚化、ダッシュボード、インデックスパターンが完全に削除されます。修復でデータを含むインデックスを削除する必要がある場合、 AWS Support はまずアクセス許可をリクエストします。設定変更が進行中の状態で 1 時間以上使用できなかった本番稼働用ドメインの場合は、本**番稼働用システム障害**以上の重要度でサポートケースを開きます。

1. 繰り返しを防ぐには、ドメインを最新のサービスソフトウェア更新に保持します。現在のリリースでは、移行失敗の一般的な原因が修正されています。ドメインが **Active** に戻ったら、更新をインストールします。

1. すべてのバージョンアップグレードの前に手動スナップショットを作成して、移行が失敗した場合に保存されたオブジェクトを復元できるようにします。スナップショットの作成の詳細については、「」を参照してください[Amazon OpenSearch Service でのインデックススナップショットの作成](managedomains-snapshots.md)。

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

## ダッシュボードが allow\_explicit\_index メッセージでロードに失敗する
<a name="dashboards-troubleshooting-allow-explicit-index"></a>

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

```
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
```
詳細オプションを変更すると、ブルー/グリーンデプロイがトリガーされるため、変更の適用には数分かかります。クラスターの高度な設定の詳細については、「」を参照してください[高度なクラスター設定](createupdatedomains.md#createdomain-configure-advanced-options)。

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

## ダッシュボードのメモリ不足
<a name="dashboards-troubleshooting-oom"></a>

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

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

緩和方法  

1. 最新のサービスソフトウェア更新をインストールします。現在のリリースでは、Dashboards が動的にヒープし、古い固定サイズ制限が削除されます。

1. **詳細設定**で を増やした場合 `savedObjects:listingLimit` (デフォルトは `1000`)、減らします。などの大きな値では`10000`、out-of-memoryエラーが発生しています。

1. ダッシュボードの複雑さ、パネルの数、自動更新の頻度を減らします。

1. メモリ使用量が長期的に多い場合は、より多くのメモリを持つインスタンスタイプにスケールします。ドメインのサイズ設定の詳細については、「」を参照してください[Amazon OpenSearch Service ドメインのサイジング](sizing-domains.md)。

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

## ペイロードサイズが原因でリクエストが失敗する
<a name="dashboards-troubleshooting-payload"></a>

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

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

緩和方法  

1. 制限を引き上げるのではなく、リクエストサイズを小さくします。
   + インデックスパターンのインデックスの数を減らします。
   + フィールドの数を減らします。
   + フィールド名の長さを短くします。

1. [AWS サポート](https://aws.amazon.com/premiumsupport/)に連絡して、ブルー/グリーンデプロイとノード交換が存続するように、増加した`server.maxPayloadBytes`値を保持するサポートされているアカウントレベルのオプションをリクエストしてください。このオプションは、サポートされているすべての Amazon OpenSearch Service バージョンで使用できます。
ノードの Dashboards 設定を自分で編集して、この制限を引き上げようとしないでください。ノードレベルの変更は永続的ではありません。Blue/Green デプロイまたはノード置換は、それらを削除します。代わりに、 AWS サポートを通じてアカウントレベルのオプションを使用します。

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

## バージョンアップグレード中はダッシュボードを使用できません
<a name="dashboards-troubleshooting-upgrade-downtime"></a>

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

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

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

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

## エンジンバージョンのアップグレードが、互換性のないインデックスでアップグレード前のチェックに失敗する
<a name="dashboards-troubleshooting-upgrade-incompatible-index"></a>

症状  
エンジンバージョンアップグレードを開始する (またはアップグレード資格チェックを実行する) と、アップグレードが始まる前にアップグレード前のチェックで失敗します。検証通知には、互換性のないインデックスが 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 インデックスは同じルールに従います。

緩和方法  

1. アップグレード適格性チェックを実行して、互換性のないインデックスの完全なリストを表示します (同じリストがアップグレード失敗通知にあります）。ドメインのアップグレードの詳細については、「」を参照してください[Amazon OpenSearch Service ドメインのアップグレード](version-migration.md)。

1. 変更を行う前に、手動スナップショットを作成します。スナップショットの作成の詳細については、「」を参照してください[Amazon OpenSearch Service でのインデックススナップショットの作成](managedomains-snapshots.md)。

1. 互換性のないデータインデックスごとに、新しいインデックス (現在のバージョンで作成) にインデックスを再作成し、古いインデックスを削除します。UltraWarm インデックスまたはコールドインデックスの場合は、まずホットストレージに移動し、インデックスを再作成してから元に戻します。

   ```
   POST _reindex
   { "source": { "index": "my-old-index" }, "dest": { "index": "my-new-index" } }
   ```

1. OpenSearch Dashboards インデックスの場合、インデックスパターン、ビジュアライゼーション、ダッシュボードを保持するため、最初にバックアップします。ダッシュボードで、**ダッシュボード管理**、**保存済みオブジェクト**に移動してエクスポートします。次に、互換性のないインデックスを削除します。新しい互換性のあるインデックスがアップグレード後に自動的に作成されます。その後、保存されたオブジェクトを再インポートします。削除しない場合は、 [AWS サポート](https://aws.amazon.com/premiumsupport/)にお問い合わせください。

1. 再インデックスを作成する代わりに、不要になった互換性のないインデックスを削除します。

1. 適格性チェックを再実行し、合格したらアップグレードを再トリガーします。

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

## ダッシュボードが正しくロードされない、空白のページが表示される、または空白のレポートを生成する
<a name="dashboards-troubleshooting-blank-page"></a>

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

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

緩和方法  

1. ブラウザのキャッシュと Cookie をクリアし、ページを再ロードします。プライベート (シークレット) ウィンドウとサポートされているup-to-dateブラウザをお試しください。

1. Dashboards URL の広告ブロッカーまたはブラウザ拡張機能を無効にします。

1. バナーがすべてのユーザー (1 つのブラウザだけでなく) に対して持続する場合は、最新のサービスソフトウェア更新をインストールし、問題が解決しない場合は [AWS サポート](https://aws.amazon.com/premiumsupport/)にお問い合わせください。

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

## サポートされていない設定
<a name="dashboards-troubleshooting-unsupported-configs"></a>

ダッシュボードの問題の一般的な原因であるこれらの設定は避けてください。
+ **ダッシュボードの前のリバースプロキシ (nginx など) は、「」で説明されているように、アクセスコントロールでのみサポート**されています[プロキシを使用して Dashboards から OpenSearch Service にアクセスする](dashboards.md#dashboards-proxy)。サードパーティーのプロキシソフトウェアを使用して Dashboards を実行し、予期しないエラーが発生した場合は、 AWS サポートに連絡する前に、プロキシなしで問題を再現してください。
+ **ノード設定ファイルへの手動編集は永続的ではありません。**Blue/Green デプロイまたはノード置換はそれらを元に戻します。ノードレベルの編集の代わりに、サポートされている設定とオプションを使用します。SSH を使用してノードにアクセスしたり、設定ファイルを直接変更したりすることはできません。

## 関連するクラスターとアクセスの問題
<a name="dashboards-troubleshooting-related"></a>

ダッシュボードは正常なクラスターとドメインのアクセス設定に依存するため、ダッシュボードが使用できない場合、次のトラブルシューティングトピックが頻繁に適用されます。これらすべてについては、「」を参照してください[Amazon OpenSearch Service のトラブルシューティング](handling-errors.md)。
+ **OpenSearch Dashboards にアクセスできません**: `User: anonymous is not authorized to perform: es:ESHttpGet` エラーや VPC アクセスリクエストのタイムアウトなど、アクセスポリシーと Amazon Cognito 認証。
+ **赤のクラスターステータス**と**黄のクラスターステータス**: 未割り当てのシャードにより、Dashboards は OpenSearch Dashboards インデックスを読み書きできなくなります。
+ **ClusterBlockException**: OpenSearch Dashboards インデックスへの書き込みを含む、低ストレージ容量または高 JVM メモリプレッシャーブロックの書き込み。
+ **JVM OutOfMemoryError** **およびリクエストスロットリング**: Dashboards エラーと`429 Too Many Requests`レスポンスとしてクラスターオーバーロード表面。