Création de règles pour envoyer QuickSight des événements Amazon à AWS Lambda - Amazon QuickSight

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 QuickSight des événements Amazon à AWS Lambda

Dans ce didacticiel, vous allez créer une AWS Lambda fonction qui enregistre les événements relatifs aux actifs dans le QuickSight compte Amazon. Vous créez ensuite une règle qui exécute la fonction chaque fois qu'un actif est modifié. Ce didacticiel part du principe que vous êtes déjà inscrit à QuickSight.

É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.

  1. Connectez-vous à la AWS Lambda console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lambda/.

  2. 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.

  3. Choisissez Créer à partir de scratch.

  4. Sur la page Créer une fonction, entrez le nom et la description de la fonction Lambda. Par exemple, nommez la fonction QuickSightAssetChangeFn.

  5. Dans Runtime, sélectionnez Node.js 18.x.

  6. Pour Architecture, choisissez x86_64.

  7. 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.

  8. Sélectionnez Create function (Créer une fonction).

  9. Sur la QuickSightAssetChangepage, choisissez index.js.

  10. Dans le panneau index.js, supprimez le code existant.

  11. Entrez l'extrait de code suivant.

    console.log('Loading function'); exports.handler = async (event, context) => { console.log('Received QuickSight event:', JSON.stringify(event)); };
  12. 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 create/update/delete un QuickSight actif.

  1. Connectez-vous à la EventBridge console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, choisissez Règles.

  3. Choisissez Créer une règle.

  4. Saisissez un nom et une description pour la règle. Par exemple, entrez QuickSightAssetChangeRule.

  5. Sélectionnez le bus d'événements par défaut.

  6. Sélectionnez Rule with an event pattern (Règle avec un modèle d'événement), puis sélectionnez Next (Suivant).

  7. Dans Source de l'événement, sélectionnez AWS événements ou événements EventBridge partenaires.

  8. Dans la section Méthode de création, choisissez Modèle personnalisé (éditeur JSON).

  9. Dans la zone de texte Modèle d'événement, entrez l'extrait suivant et choisissez Next.

    { "source": ["aws.quicksight"] }

    Vous pouvez également créer la règle qui s'abonne uniquement à un sous-ensemble de types d'événements sur Amazon. QuickSight 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 identifiant77e307e8-b41b-472a-90e8-fe3f471537be.

    { "source": ["aws.quicksight"], "detail-type": ["QuickSight Folder Membership Updated"], "detail": { "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } }
  10. Pour les types de cible, choisissez le AWS service et la fonction Lambda.

  11. Dans Function (Fonction), choisissez la fonction Lambda que vous avez créée. Ensuite, sélectionnez Suivant.

  12. Dans la rubrique Configure tags (Configurer les balises), sélectionnez Next (Suivant).

  13. 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 une minute d'attente, vérifiez que votre fonction Lambda a été invoquée.

  1. Ouvrez la QuickSight console Amazon à l'adresse https://quicksight.aws.amazon.com/.

  2. Créez une nouvelle analyse.

  3. Dans le volet de navigation, cliquez sur Rules (Règles), puis sur le nom de la règle que vous avez créée.

  4. Dans Détails des règles, choisissez Surveillance.

  5. Vous serez redirigé vers la CloudWatch console Amazon. Si vous n'êtes pas redirigé, choisissez Afficher les statistiques dans CloudWatch.

  6. Dans All metrics (Toutes les métriques), cliquez sur le nom de la règle que vous avez créée. Le graphique indique que la règle était en cause.

  7. Dans le panneau de navigation, choisissez Groupes de journaux.

  8. Choisissez le nom du groupe de journaux pour votre fonction Lambda. Par exemple, /aws/lambda/function-name.

  9. 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' QuickSight événement au format JSON, consultez la section Présentation des événements pour Amazon QuickSight.