AWSSupport-TroubleshootGlueConnection

AutomationAssumeRole (Fakultativ):

Der Amazon-Ressourcenname (ARN) der AWS AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

TestConnectionRole (Erforderlich)

Der Amazon-Ressourcenname (ARN) der IAM-Rolle, der während des Verbindungstests verwendet wird.

ConnectionName (Erforderlich)

AWS Glue Name der fehlgeschlagenen Testverbindung, die Sie beheben möchten.

PersistReachabilityAnalyzerResults(Fakultativ)

Das Kennzeichen, das darüber informiert, ob die Ergebnisse der Reachability Analyzer-Ausführung beibehalten werden sollen oder nicht. Standard: false.

PointOfPresenceLogRetentionPeriod(Fakultativ)

Die Anzahl der Tage, für die die Protokolle für den Point of Presence Lambda gespeichert werden. Standard: 7.

DatasourceSubnets (Fakultativ)

Wenn die ursprüngliche Datenquelle nicht verfügbar ist, verwenden Sie diesen Parameter, um die verwendeten Subnetze anzugeben, sodass die Konnektivitätstests weiterhin durchgeführt werden. Muss mit verwendet werden. DatasourceSecurityGroups Beispiel: subnet-1,subnet-2.

DatasourceSecurityGroups (Fakultativ)

Wenn die ursprüngliche Datenquelle nicht verfügbar ist, verwenden Sie diesen Parameter, um die verwendeten Sicherheitsgruppen anzugeben, sodass die Konnektivitätstests weiterhin durchgeführt werden. Muss mit verwendet werden. DatasourceSubnets Beispiel: sg-1,sg-2.

ParseInputs:

In diesem Schritt wird die Kombination von Eingaben validiert. Wenn beide DatasourceSecurityGroups angegeben DatasourceSubnets werden, sind sie gültig und werden unverändert zurückgegeben. Wenn keine angegeben werden, werden zwei leere Listen zurückgegeben. Wenn nur eine von ihnen bereitgestellt wird, löst der Schritt eine ausValueException.

GetConnectionDetails:

Dieser Schritt gibt die Details der bereitgestellten AWS Glue Verbindung zurück.

ParseSecurityGroupList:

Dieser Schritt wird verwendet, um das SecurityGroupIdList In a String für die zukünftige Verwendung in dieser Automatisierung zu verketten.

GetConnectionData:

Ermittelt anhand der JDBC-URL, welche Art von Verbindung zwischen:, und. RedShift RdsInstance RdsCluster Other Gibt außerdem die in der JDBC-Verbindung verwendete Domain und den Port, die Amazon VPC der Verbindung und ihre Domainnamenserver zurück.

GetNetworkDetails:

Ruft die Subnetz- und Sicherheitsgruppeninformationen vom Amazon RDS- oder Amazon Redshift-Ziel ab.

Eine Vorlage erstellen:

Generiert die AWS CloudFormation Vorlage, die zum Erstellen der Netzwerkschnittstellen verwendet wird, die zum Testen der Konnektivität verwendet werden. Dies ist erforderlich, um das Reachability Analyzer-Tool auszuführen.

ENIStack erstellen:

Erstellt den CloudFormation Stapel aus der Vorlage, die im vorherigen Schritt erstellt wurde.

GetStackDetails:

Beschreibt den CloudFormation Stapel, der im vorherigen Stapel erstellt wurde, und ruft die SourceNetworkInterface TargetNetworkInterfaces Informationen ab.

RunSourceToTargetCheck:

Führt mithilfe des Reachability Analyzer-Tools Überprüfungen zwischen den Quell- und Ziel-ENIs durch, die im vorherigen Schritt erstellt wurden.

ENI-Stack löschen:

Löscht den Stack, der CloudFormation Netzwerkschnittstellen erstellt

CreateNetworkPointOfPresence:

CloudFormation erstellt die Lambda-Funktion, die als Netzwerkpoint of Presence verwendet wird.

GetFunctionName:

Führt einen CloudFormation Describe-Stack-API-Aufruf durch, um den Namen der im vorherigen Schritt erstellten Lambda-Funktion abzurufen.

RunEndpointChecks:

Ermittelt anhand des Network Point of Presence, ob der in der JDBC-Verbindung vorhandene Endpunkt über den deklarierten Port auflösbar und erreichbar ist.

Überprüft die S3-Konnektivität:

Überprüft die Netzwerkkonnektivität von der AWS Glue Verbindung zum Amazon S3-Service.

DeletePointOfPresence:

Löscht den CloudFormation Stack, der den Network Point of Presence Lambda erstellt.

TestIAMRolePermissions:

Überprüft, ob die für den Test verwendete IAM-Rolle über die erforderlichen Berechtigungen verfügt, um ihn auszuführen.

CheckConnectionSecurityGroupReferencingRule:

Prüft, ob die in der AWS Glue Verbindung verwendete Sicherheitsgruppe den gesamten eingehenden Datenverkehr von sich aus zulässt. Es wird eine Liste der Sicherheitsgruppen ohne diese Regel zurückgegeben, falls vorhanden.

GenerateReport:

Generiert einen Bericht, der eine Liste der Ergebnisse (mögliche Gründe für den Fehler beim Verbindungstest) und die nächsten Schritte (Versuche, den Fehler beim Verbindungstest zu beheben) enthält.

Ergebnisse der Automatisierung

In diesem Abschnitt finden Sie Szenarien, in denen mögliche Ursachen für das Scheitern des Testverbindungsvorgangs (Ergebnisse) beschrieben werden und wie diese behoben werden können (nächste Schritte). Wenn die Automatisierung die Ursache für den Testfehler nicht finden kann, wird dies ebenfalls in diesem Abschnitt mitgeteilt.

Erfolgreiche Tests

In diesem Abschnitt finden Sie Szenarien, die darüber informieren, was mit dieser Automatisierung erfolgreich getestet wurde. Erfolgreiche Tests sind nützlich, falls die Automatisierung nicht in der Lage ist, die Ursache für den Ausfall der Testverbindung zu identifizieren, da sie den Umfang der Untersuchung einschränken, da sie darüber informieren, was nicht zu dem Problem beiträgt.

Fehler bei der Automatisierung

In diesem Abschnitt finden Sie Szenarien, die Probleme beschreiben, die während der Automatisierung aufgetreten sind und die möglicherweise die Anzahl der Tests begrenzt haben, die die Automatisierung durchführen konnte. Die Beschreibung des Szenarios gibt Aufschluss darüber, welcher Schritt fehlgeschlagen ist.