View a markdown version of this page

OpenSearch UI での VPC 接続の問題の解決 - Amazon OpenSearch Service

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

OpenSearch UI での VPC 接続の問題の解決

OpenSearch UI アプリケーションが VPC 内のドメインに到達できない場合、原因は通常、VPC エンドポイント認可の欠落、ポート 443 をブロックするセキュリティグループ、または VPC でオフになっている DNS 属性です。次の表に、VPC 接続の問題の症状と考えられる原因を示します。これにより、どこから始めるかを特定できます。

症状 考えられる原因
データソースが使用できないことをレポートする VPC エンドポイントへのアクセスが許可されていません
データソースが異常であると報告する セキュリティグループがトラフィックをブロックしている
アプリケーションがドメインに到達できない VPC で DNS 解決が有効になっていない
接続が断続的に機能する ドメインが変更を処理しているか、エンドポイントが再プロビジョニングされている

VPC エンドポイントアクセスの許可

最も一般的な VPC の問題は、OpenSearch UI サービスが VPC エンドポイントにアクセスする権限がないことです。認可が存在するかどうかを確認します。

aws opensearch list-vpc-endpoint-access \ --domain-name {{domain-name}} \ --region {{region}}

レスポンスに が含まれていない場合はapplication.opensearchservice.amazonaws.com、承認します。

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

認可が伝播されるまで 5~10 分待ってから、アプリケーションのデータソースの状態を確認します。

サーバーレスコレクションは、エンドポイント認可の代わりにネットワークポリシーを使用します。ポリシーは、 の OpenSearch UI サービスを一覧表示する必要がありますSourceServices。存在するポリシーを確認するには、 を実行しますaws opensearchserverless list-security-policies --type network。

セキュリティグループを介したトラフィックの許可

エンドポイントアクセスが承認された場合でも、ドメインのセキュリティグループは TCP ポート 443 でのインバウンドトラフィックを許可する必要があります。次のコマンドは、セキュリティグループを検索し、そのインバウンドルールを確認します。プレースホルダー値は、ユーザー自身の情報に置き換えてください。

aws opensearch describe-domain \ --domain-name {{domain-name}} \ --region {{region}} \ --query 'DomainStatus.VPCOptions.SecurityGroupIds' aws ec2 describe-security-groups \ --group-ids {{security-group-id}} \ --region {{region}} \ --query 'SecurityGroups[0].IpPermissions'

インバウンドルールを追加するには、VPC CIDR ブロックを指定するか、より厳密な制御のために VPC エンドポイントのセキュリティグループをソースとして指定します。

aws ec2 authorize-security-group-ingress \ --group-id {{security-group-id}} \ --protocol tcp \ --port 443 \ --source-group {{endpoint-security-group-id}} \ --region {{region}}

次の表に、一般的なセキュリティグループのミスを示します。

ミス 失敗する理由 解決策
ポート 9200 のみを許可する OpenSearch UI がポート 443 で HTTPS を使用する TCP 443 のインバウンドルールを追加する
ソースを特定の IP アドレスに制限する VPC エンドポイントの IP アドレスは変更される可能性があります CIDR ブロックを使用するか、セキュリティグループを参照する
アウトバウンドルールなし レスポンスがエンドポイントに到達できない アウトバウンドトラフィックを許可する
間違った VPC CIDR ブロック ソース範囲がエンドポイントサブネットと一致しません エンドポイントを保持する VPC の CIDR ブロックを使用する

DNS 解決の有効化

VPC エンドポイントは、トラフィックをルーティングするために DNS に依存します。enableDnsSupport と の両方が VPC true上にあるenableDnsHostnames必要があります。次のコマンドは、各属性をチェックし、必要に応じて有効にします。プレースホルダー値は、ユーザー自身の情報に置き換えてください。

aws ec2 describe-vpc-attribute \ --vpc-id {{vpc-id}} \ --attribute enableDnsSupport \ --region {{region}} aws ec2 modify-vpc-attribute \ --vpc-id {{vpc-id}} \ --enable-dns-support '{"Value": true}' \ --region {{region}} aws ec2 describe-vpc-attribute \ --vpc-id {{vpc-id}} \ --attribute enableDnsHostnames \ --region {{region}} aws ec2 modify-vpc-attribute \ --vpc-id {{vpc-id}} \ --enable-dns-hostnames '{"Value": true}' \ --region {{region}}

Route 53 プライベートホストゾーンを使用する場合は、VPC エンドポイントの DNS エントリを上書きしないことを確認します。カスタム DNS 設定は、VPC エンドポイントが依存する解決を妨げる可能性があります。

断続的な OpenSearch UI VPC 接続の解決

断続的な接続は通常、設定エラーではなく一時的な状態を反映します。一般的な原因は以下の通りです。

  • 設定変更を処理しているドメイン。

  • 誰かが変更したセキュリティグループ。

  • ドメインの変更後に OpenSearch UI が再プロビジョニングする VPC エンドポイント。

  • ドメインのリソースプレッシャー。

ドメインが変更を処理しているかどうかを確認します。

aws opensearch describe-domain \ --domain-name {{domain-name}} \ --query 'DomainStatus.Processing'

値が の場合true、変更が終了するのを待ちます。Amazon CloudWatch でドメインのCPUUtilizationメトリクスを確認することもできます。

VPC 接続要件の確認

  • VPC エンドポイントへのアクセスは に対して許可されていますapplication.opensearchservice.amazonaws.com。

  • セキュリティグループは、インバウンド TCP 443 を許可し、アウトバウンドトラフィックを許可します。

  • VPC では、DNS サポートと DNS ホスト名が有効になっています。

  • ドメインはアクティブであり、変更を処理していません。

  • ドメインのアクセスポリシーは、OpenSearch UI サービスプリンシパルを許可します。

  • サーバーレスコレクションの場合、ネットワークポリシーは のサービスを一覧表示しSourceServices、データアクセスポリシーは読み取りアクセス許可を付与します。

  • 競合する Route 53 プライベートホストゾーンがエンドポイント DNS を上書きすることはありません。