Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création de règles pour envoyer des événements Amazon Quick Sight à AWS Lambda
Dans ce didacticiel, vous allez créer une AWS Lambda fonction qui enregistre les événements relatifs aux actifs dans le compte Amazon Quick Sight. Vous créez ensuite une règle qui exécute la fonction chaque fois qu’il y a un changement d’actif. Ce didacticiel part du principe que vous êtes déjà inscrit à Amazon Quick Sight.
Étape 1 : Création d'une Lambda fonction
Créez une fonction Lambda pour enregistrer les événements de changement d’état. Vous spécifiez cette fonction lors de la création de votre règle.
-
Connectez-vous à la AWS Lambda console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lambda/
. -
Si vous utilisez Lambda pour la première fois, une page de bienvenue s’affiche. Sélectionnez Pour commencer. Sinon, choisissez Créer la fonction.
-
Choisissez Créer à partir de scratch.
-
Sur la page de création de la fonction, saisissez un nom et une description pour la fonction Lambda. Par exemple, nommez la fonction
QuickSightAssetChangeFn. -
Dans Runtime (exécution), sélectionnez Node.js 18x.
-
Pour Architecture, choisissez x86_64.
-
Pour le rôle d’exécution, choisissez soit Créer un nouveau rôle avec des autorisations Lambda de base, soit Utiliser un rôle existant et choisissez le rôle que vous souhaitez.
-
Choisissez Créer une fonction.
-
Sur la QuickSightAssetChangepage, choisissez index.js.
-
Dans le panneau index.js, supprimez le code existant.
-
Saisissez le code snippet suivant.
console.log('Loading function'); exports.handler = async (event, context) => { console.log('Received QuickSight event:', JSON.stringify(event)); }; -
Choisissez Deploy (Déployer).
Étape 2 : création d’une règle
Créez une règle pour exécuter votre fonction Lambda chaque fois que vous êtes une ressource create/update/delete Amazon Quick Sight.
Connectez-vous à la EventBridge console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/events/
. -
Dans le panneau de navigation, choisissez Rules.
-
Choisissez Créer une règle.
-
Saisissez un nom et une description pour la règle. Par exemple, entrez
QuickSightAssetChangeRule. -
Sélectionnez le bus d’événements par défaut.
-
Sélectionnez Rule with an event pattern (Règle avec un modèle d’événement), puis sélectionnez Next (Suivant).
-
Dans Source de l'événement, sélectionnez AWS événements ou événements EventBridge partenaires.
-
Dans la section Méthode de création, pour Méthode, choisissez Modèle personnalisé (éditeur JSON).
-
Dans la zone de texte Modèle d’événement, entrez l’extrait suivant et choisissez Next (Suivant).
{ "source": ["aws.quicksight"] }Vous pouvez également créer la règle qui s'abonne uniquement à un sous-ensemble de types d'événements dans Amazon Quick Sight. Par exemple, la règle suivante ne sera déclenchée que lorsqu’une ressource est ajoutée ou supprimée d’un dossier portant un identifiant
77e307e8-b41b-472a-90e8-fe3f471537be.{ "source": ["aws.quicksight"], "detail-type": ["QuickSight Folder Membership Updated"], "detail": { "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } } -
Pour les types de cible, choisissez le AWS service et la fonction Lambda.
-
Dans Function (Fonction), choisissez la fonction Lambda que vous avez créée. Ensuite, sélectionnez Suivant.
-
Dans la rubrique Configure tags (Configurer les balises), sélectionnez Next (Suivant).
-
Passez en revue les étapes de votre règle. Puis, choisissez Create rule (Créer une règle).
Étape 3 : test de la règle
Pour tester votre règle, créez une analyse. Après avoir attendu quelques minutes que l’instance s’arrête, vous pouvez vérifier que votre fonction Lambda a été invoquée.
-
Ouvrez la console Amazon Quick Sight à l'https://quicksight---aws.amazon.com.rproxy.govskope.caadresse/
. -
Créez une nouvelle analyse.
-
Dans le panneau de navigation, cliquez sur Rules (Règles), puis sur le nom de la règle que vous avez créée.
-
Dans Détails des règles, choisissez Surveillance.
-
Vous serez redirigé vers la CloudWatch console Amazon. Si vous n'êtes pas redirigé, choisissez Afficher les statistiques dans CloudWatch.
-
Dans All metrics (Toutes les métriques), cliquez sur le nom de la règle que vous avez créée. Le graphique doit indiquer que la règle a été invoquée.
-
Dans le panneau de navigation, choisissez Groupes de journaux.
-
Choisissez le nom du groupe de journaux de votre fonction Lambda. Par exemple,
/aws/lambda/function-name. -
Choisissez le nom du flux de journaux pour afficher les données fournies par la fonction concernant l’instance que vous avez lancée. Vous devez voir un événement reçu semblable à ce qui suit :
{ "version": "0", "id": "3acb26c8-397c-4c89-a80a-ce672a864c55", "detail-type": "QuickSight Analysis Creation Successful", "source": "aws.quicksight", "account": "123456789012", "time": "2023-10-30T22:06:31Z", "region": "us-east-1", "resources": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"], "detail": { "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } }
Pour un exemple d'événement Amazon Quick Sight au format JSON, consultez Présentation des événements pour Amazon Quick Sight.