

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Lösung von VPC-Konnektivitätsproblemen in OpenSearch UI

Wenn ein OpenSearch Eine UI-Anwendung kann eine Domain in einer VPC nicht erreichen. Die Ursache dafür ist in der Regel eine fehlende VPC-Endpunktautorisierung, eine Sicherheitsgruppe, die Port 443 blockiert, oder DNS-Attribute, die auf der VPC deaktiviert sind. In der folgenden Tabelle sind die Symptome und wahrscheinlichen Ursachen von VPC-Verbindungsproblemen aufgeführt, sodass Sie herausfinden können, wo Sie beginnen müssen.


| Symptom | Wahrscheinliche Ursache | 
| --- | --- | 
| Die Datenquelle meldet, dass sie nicht verfügbar ist | Der VPC-Endpunktzugriff ist nicht autorisiert | 
| Die Datenquelle meldet, dass sie fehlerhaft ist | Eine Sicherheitsgruppe blockiert den Verkehr | 
| Die Anwendung kann die Domäne nicht erreichen | Die DNS-Auflösung ist auf der VPC nicht aktiviert | 
| Die Konnektivität funktioniert zeitweise | Die Domain verarbeitet eine Änderung oder der Endpunkt wird gerade neu bereitgestellt | 

## Autorisierung des VPC-Endpunktzugriffs
<a name="application-troubleshooting-vpc-authorization"></a>

Das häufigste VPC-Problem ist, dass OpenSearch Der UI-Dienst ist nicht berechtigt, auf den VPC-Endpunkt zuzugreifen. Prüfen Sie, ob die Autorisierung besteht:

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

Wenn die Antwort Folgendes nicht beinhaltet `application.opensearchservice.amazonaws.com`, autorisiere es:

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

Warten Sie 5 bis 10 Minuten, bis die Autorisierung wirksam ist, und überprüfen Sie dann den Zustand der Datenquelle in Ihrer Anwendung.

Serverlose Sammlungen verwenden eine Netzwerkrichtlinie anstelle einer Endpunktautorisierung. Die Richtlinie muss Folgendes auflisten OpenSearch UI-Dienst in `SourceServices`. Um die vorhandenen Richtlinien zu überprüfen, führen Sie Folgendes aus `aws opensearchserverless list-security-policies --type network`.

## Verkehr durch eine Sicherheitsgruppe zulassen
<a name="application-troubleshooting-vpc-securitygroup"></a>

Selbst wenn der Endpunktzugriff autorisiert ist, muss die Sicherheitsgruppe der Domäne eingehenden Verkehr auf TCP-Port 443 zulassen. Mit den folgenden Befehlen wird die Sicherheitsgruppe gefunden und ihre Regeln für eingehenden Datenverkehr überprüft. Ersetzen Sie die {{placeholder values}} mit deinen eigenen Informationen:

```
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'
```

Um eine Regel für eingehenden Datenverkehr hinzuzufügen, geben Sie entweder Ihren VPC-CIDR-Block oder, zur besseren Kontrolle, die Sicherheitsgruppe des VPC-Endpunkts als Quelle an:

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

In der folgenden Tabelle sind häufig auftretende Fehler in Sicherheitsgruppen aufgeführt.


| Irrtum | Warum scheitert es | Auflösung | 
| --- | --- | --- | 
| Nur Port 9200 zulassen | OpenSearch UI verwendet HTTPS auf Port 443 | Fügen Sie eine Regel für eingehenden Datenverkehr für TCP 443 hinzu | 
| Beschränkung der Quelle auf eine bestimmte IP-Adresse | Die IP-Adresse des VPC-Endpunkts kann sich ändern | Verwenden Sie einen CIDR-Block oder verweisen Sie auf eine Sicherheitsgruppe | 
| Keine Regeln für ausgehenden Datenverkehr | Antworten können den Endpunkt nicht erreichen | Ausgehenden Verkehr zulassen | 
| Der falsche VPC-CIDR-Block | Der Quellbereich entspricht nicht dem Endpunkt-Subnetz | Verwenden Sie den CIDR-Block der VPC, die den Endpunkt enthält | 

## DNS-Auflösung aktivieren
<a name="application-troubleshooting-vpc-dns"></a>

VPC-Endpunkte sind auf DNS angewiesen, um den Datenverkehr weiterzuleiten. Beides `enableDnsSupport` und `enableDnsHostnames` muss sein `true` auf der VPC. Die folgenden Befehle überprüfen jedes Attribut und aktivieren es bei Bedarf. Ersetzen Sie das {{placeholder values}} mit deinen eigenen Informationen:

```
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}}
```

Wenn Sie private gehostete Zonen von Route 53 verwenden, stellen Sie sicher, dass diese die DNS-Einträge des VPC-Endpunkts nicht überschreiben. Eine benutzerdefinierte DNS-Konfiguration kann die Auflösung beeinträchtigen, auf die VPC-Endpunkte angewiesen sind.

## Intermittierend beheben OpenSearch UI VPC-Konnektivität
<a name="application-troubleshooting-vpc-intermittent"></a>

Intermittierende Konnektivität ist in der Regel eher auf einen vorübergehenden Zustand als auf einen Konfigurationsfehler zurückzuführen. Zu den häufigsten Ursachen gehören die folgenden:
+ Eine Domäne, die eine Konfigurationsänderung verarbeitet.
+ Eine Sicherheitsgruppe, die jemand geändert hat.
+ Ein VPC-Endpunkt, der OpenSearch Die Benutzeroberfläche wird nach einer Domänenänderung erneut bereitgestellt.
+ Der Ressourcendruck auf der Domain.

Prüfen Sie, ob die Domain eine Änderung verarbeitet:

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

Wenn der Wert `true`, warten Sie, bis die Änderung abgeschlossen ist. Sie können auch das überprüfen `CPUUtilization` Metrik für die Domain in Amazon CloudWatch.

## Überprüfung der VPC-Konnektivitätsanforderungen
<a name="application-troubleshooting-vpc-checklist"></a>
+ Der VPC-Endpunktzugriff ist autorisiert für `application.opensearchservice.amazonaws.com`.
+ Die Sicherheitsgruppe erlaubt eingehenden TCP 443 und lässt ausgehenden Verkehr zu.
+ Die VPC bietet DNS-Unterstützung und aktivierte DNS-Hostnamen.
+ Die Domain ist aktiv und verarbeitet keine Änderung.
+ Die Zugriffsrichtlinie der Domain ermöglicht die OpenSearch UI-Serviceprinzipal.
+ Bei einer serverlosen Sammlung listet die Netzwerkrichtlinie den Dienst in `SourceServices`, und die Datenzugriffsrichtlinie gewährt Leseberechtigungen.
+ Keine widersprüchliche private gehostete Route 53-Zone überschreibt das Endpunkt-DNS.