AWSSupport-TroubleshootGlueConnection

AutomationAssumeRole (Facultatif) :

Le nom de ressource Amazon (ARN) du rôle AWS Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

TestConnectionRole (Obligatoire)

Le nom de ressource Amazon (ARN) du rôle IAM utilisé lors du test de connexion.

ConnectionName (Obligatoire)

AWS Glue nom de connexion ayant échoué au test que vous souhaitez résoudre.

PersistReachabilityAnalyzerResults(Facultatif)

L'indicateur indiquant si les résultats de l'exécution de l'analyseur d'accessibilité doivent être conservés ou non. Valeur par défaut : false.

PointOfPresenceLogRetentionPeriod(Facultatif)

Le nombre de jours pendant lesquels les journaux du point de présence Lambda seront conservés. Valeur par défaut : 7.

DatasourceSubnets (Facultatif)

Si la source de données d'origine n'est pas disponible, utilisez ce paramètre pour indiquer les sous-réseaux qu'elle a utilisés afin que les tests de connectivité soient toujours effectués. Doit être utilisé avecDatasourceSecurityGroups. Exemple: subnet-1,subnet-2.

DatasourceSecurityGroups (Facultatif)

Si la source de données d'origine n'est pas disponible, utilisez ce paramètre pour indiquer les groupes de sécurité qu'elle a utilisés afin que les tests de connectivité soient toujours effectués. Doit être utilisé avecDatasourceSubnets. Exemple: sg-1,sg-2.

ParseInputs:

Cette étape valide la combinaison des entrées. Si DatasourceSecurityGroups les deux DatasourceSubnets sont fournis, ils sont valides et renvoyés tels quels. Si aucune n'est fournie, deux listes vides sont renvoyées. Si un seul d'entre eux est fourni, l'étape génère unValueException.

GetConnectionDetails:

Cette étape renvoie les détails de la AWS Glue connexion fournie.

ParseSecurityGroupList:

Cette étape est utilisée pour concaténer le SecurityGroupIdList in a String pour une utilisation future dans cette automatisation.

GetConnectionData:

Détermine, en fonction de l'URL JDBC, le type de connexion entre : RedShiftRdsInstance, RdsCluster et. Other Renvoie également le domaine et le port utilisés dans la connexion JDBC, l'Amazon VPC de la connexion et ses serveurs de noms de domaine.

GetNetworkDetails:

Obtient les informations sur le sous-réseau et le groupe de sécurité à partir de la cible Amazon RDS ou Amazon Redshift.

Créer un modèle ENI :

Génère le AWS CloudFormation modèle utilisé pour créer les interfaces réseau utilisées pour tester la connectivité. Cela est nécessaire pour exécuter l'outil Reachability Analyzer.

Créez EnisStack :

Crée la CloudFormation pile à partir du modèle créé à l'étape précédente.

GetStackDetails:

Décrit la CloudFormation pile créée dans la pile précédente et récupère les SourceNetworkInterface TargetNetworkInterfaces informations.

RunSourceToTargetCheck:

Exécute des vérifications entre les ENI source et cible créés à l'étape précédente à l'aide de l'outil Reachability Analyzer.

Supprimer EISStack :

Supprime la CloudFormation pile qui crée les interfaces réseau

CreateNetworkPointOfPresence:

CloudFormation crée la fonction Lambda utilisée comme point de présence réseau.

GetFunctionName:

Exécute un appel d'API CloudFormation describe stack pour récupérer le nom de la fonction Lambda créée à l'étape précédente.

RunEndpointChecks:

Utilise le point de présence du réseau pour déterminer si le point de terminaison présent dans la connexion JDBC peut être résolu et accessible sur le port déclaré.

Connectivité CheckS3 :

Vérifie la connectivité réseau depuis la AWS Glue connexion au service Amazon S3.

DeletePointOfPresence:

Supprime la CloudFormation pile qui crée le point de présence du réseau Lambda.

TestIAMRolePermissions:

Vérifie si le rôle IAM utilisé pour le test possède les autorisations nécessaires pour l'exécuter.

CheckConnectionSecurityGroupReferencingRule:

Vérifie si le groupe de sécurité utilisé dans la AWS Glue connexion autorise tout le trafic entrant depuis lui-même. Il renverra une liste des groupes de sécurité sans cette règle, le cas échéant.

GenerateReport:

Génère un rapport contenant une liste des résultats (raisons possibles de l'échec du test de connexion) et des étapes suivantes (tentatives de résolution de l'échec du test de connexion).

Résultats de l'automatisation

Dans cette section, vous trouverez des scénarios décrivant les causes possibles de l'échec de l'opération de test de connexion (résultats) et la manière dont elles peuvent être corrigées (étapes suivantes). Si l'automatisation ne trouve pas la cause de l'échec du test, cela sera également indiqué dans cette section.

Tests réussis

Dans cette section, vous trouverez des scénarios indiquant ce qui a été testé avec succès par cette automatisation. Les tests réussis sont utiles si l'automatisation n'est pas en mesure d'identifier la cause de l'échec de la connexion de test, car ils réduisent la portée de l'enquête en informant ce qui ne contribue pas au problème.

Erreurs d'automatisation

Dans cette section, vous trouverez des scénarios décrivant les problèmes survenus lors de l'automatisation et qui ont pu limiter le nombre de tests que l'automatisation pouvait effectuer. La description du scénario indiquera quelle étape a échoué.