View a markdown version of this page

OpenSearch UI でのデータソースのヘルスとアクセスエラーの解決 - Amazon OpenSearch Service

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

OpenSearch UI でのデータソースのヘルスとアクセスエラーの解決

OpenSearch UI アプリケーションに関連付ける各データソースは、ヘルスステータスを報告します。

ステータス 意味 必要なアクション
緑、または正常 接続および運用 なし
Yellow レプリカシャードが未割り当てであるため、接続されているがパフォーマンスが低下する モニタリングします。これにより、単独で解決できます。
赤、または異常 接続されているが、プライマリシャードは使用できない ドメインの状態を調査する
使用不可 接続を確立できない アクセス許可、VPC 設定、ドメインステータスを確認する

ドメインが見つかりません

がドメインが存在しないことをupdate-application報告した場合は、以下を確認します。

  • ドメインがアプリケーションとは異なる AWS リージョンにある。を使用して、各リージョンのドメインを一覧表示しますaws opensearch list-domain-names --region region。

  • ドメインは別の AWS アカウントにあります。クロスアカウントアクセスの詳細については、「クロスリージョンおよびクロスアカウントデータアクセス」を参照してください。

  • ARN に誤ったドメイン名が含まれています。

  • ドメインが削除されました。で を確認しますaws opensearch describe-domain --domain-name domain-name。

データソースを関連付けるとアクセスが拒否されます

で使用しているプリンシパルを確認しaws sts get-caller-identity、次のアクセス許可があることを確認します。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "es:UpdateApplication", "es:DescribeDomain", "es:DescribeDomains" ], "Resource": "*" } ] }

次に、ドメインのアクセスポリシーを確認します。

aws opensearch describe-domain-config \ --domain-name {{domain-name}} \ --query 'DomainConfig.AccessPolicies' \ --region {{region}}

ドメインのアクセスポリシーでは、OpenSearch UI サービスプリンシパルを許可する必要があります。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "application.opensearchservice.amazonaws.com" }, "Action": "es:ESHttp*", "Resource": "arn:aws:es:{{region}}:{{account-id}}:domain/{{domain-name}}/*" } ] }

データソース ARN が拒否されました

次の表に、各種類のデータソースに必要な ARN 形式を示します。

データソースタイプ ARN 形式
マネージドドメイン arn:aws:es:region:account-id:domain/domain-name
サーバーレスコレクション arn:aws:aoss:region:account-id:collection/collection-id
注記

サーバーレスコレクションは aossではなく を使用しes、コレクション名ではなくコレクション ID を使用します。ID を検索するには、 を実行しますaws opensearchserverless list-collections。

クロスアカウントデータソースが保留中または使用できない

接続が保留中のままの場合、誰も接続を受け入れていません。保留中の接続を一覧表示し、予想される接続を受け入れます。

aws opensearch describe-inbound-connections \ --filters '[{"Name":"connection-status","Values":["PENDING_ACCEPTANCE"]}]' \ --region {{region}} aws opensearch accept-inbound-connection \ --connection-id {{connection-id}} \ --region {{region}}

クロスアカウントドメインが使用不可であると報告した場合は、クロスクラスター接続がアクティブであること、リモートドメインのアクセスポリシーにソースアカウントが含まれていること、VPC ドメインの場合は、VPC エンドポイントアクセスが OpenSearch UI サービスプリンシパルに対して承認されていることを確認します。

aws opensearch authorize-vpc-endpoint-access \ --domain-name {{domain-name}} \ --service application.opensearchservice.amazonaws.com \ --region {{region}}

データソースが異常であると報告する

データソースが異常な場合、アプリケーションは接続できますが、ドメイン自体に問題があります。

原因 症状 解決策
赤のクラスター状態 プライマリシャードは使用できません ディスク容量とノードの状態を確認する
ドメインは変更を処理しています 設定の変更が進行中です 処理が完了するまで待機する
JVM メモリ負荷が高い クエリとタイムアウトの遅延 インスタンスタイプをスケールアップするか、ノードを追加する
ディスク容量がいっぱいです 書き込み拒否 古いインデックスを削除するか、ストレージを増やす
シャードが多すぎる クラスターの不安定性 シャード数を減らし、インデックス状態管理ポリシーを使用する

サーバーレスコレクションに到達できない

コレクションがデータソースリストに表示されない場合は、コレクションが存在し、アクティブであること、コレクションがアプリケーションと同じ AWS リージョンにあること、IAM アクセス許可に が含まれていることを確認しますaoss:BatchGetCollection。

アクセス拒否を報告するコレクションには、サービスの接続を許可するネットワークポリシーと、サービスがデータを読み取ることを許可するデータアクセスポリシーの両方が必要です。ネットワークポリシーは、 の OpenSearch UI サービスを一覧表示する必要がありますSourceServices。

[{ "Rules": [{ "ResourceType": "collection", "Resource": ["collection/{{collection-name}}"] }], "SourceServices": ["application.opensearchservice.amazonaws.com"] }]

既存のポリシーを確認するには、 aws opensearchserverless list-security-policies --type networkと を実行しますaws opensearchserverless list-access-policies --type data。

正常なデータソースが使用できなくなる

次の項目を順番に確認します。

  1. ドメインが設定変更を受けているかどうか。

  2. 誰かがドメインのアクセスポリシーを変更したかどうか。

  3. 誰かが VPC エンドポイント認可を取り消したかどうか。

  4. 誰かがセキュリティグループのルールを変更したかどうか。

アクションはデータソースを再接続しません。接続を再確立するには、データソースを削除し、2~3 分待ってから再度追加します。

重要

update-application コマンドはデータソースリスト全体を置き換えます。保持するすべてのデータソースを含めます。