Pour déployer et abonner le pipeline de recherche et d'analyse d'événements - Amazon Simple Notification Service

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.

Pour déployer et abonner le pipeline de recherche et d'analyse d'événements

Pour l'archivage et l'analyse des événements, Amazon SNS recommande désormais d'utiliser son intégration native avec Amazon Data Firehose. Vous pouvez abonner les flux de diffusion Firehose aux rubriques SNS, ce qui vous permet d'envoyer des notifications aux points de terminaison d'archivage et d'analyse tels que les buckets Amazon Simple Storage Service (Amazon S3), les tables Amazon Redshift, Amazon Service (Service), etc. OpenSearch OpenSearch L'utilisation d'Amazon SNS avec les flux de diffusion Firehose est une solution entièrement gérée et sans code qui ne nécessite pas l'utilisation de fonctions. AWS Lambda Pour plus d’informations, consultez Streams de diffusion de Fanout to Firehose.

Cette page montre comment déployer le Pipeline de recherche et d'analyse des événements et vous abonner à une rubrique Amazon SNS. Ce processus transforme automatiquement le modèle AWS SAM associé au pipeline en pile AWS CloudFormation, puis déploie la pile dans votre Compte AWS. De plus, ce processus crée et configure l'ensemble de ressources qui comprennent le pipeline de recherche et d'analyse des événements, y compris ce qui suit :

  • File d’attente Amazon SQS

  • Fonction Lambda

  • Flux de diffusion Firehose

  • Domaine Amazon OpenSearch Service

  • Compartiment de lettres mortes Amazon S3

Pour plus d'informations sur la configuration d'un flux avec un index comme destination, consultez le ElasticsearchDestinationConfiguration manuel Amazon Data Firehose API Reference.

Pour plus d'informations sur la transformation des événements et sur la configuration de la mise en mémoire tampon des événements, de la compression des événements et du chiffrement des événements, consultez la section Création d'un flux de diffusion Amazon Data Firehose dans le manuel du développeur Amazon Data Firehose.

Pour plus d'informations sur le filtrage des événements, consultez la section Stratégies de filtre d'abonnement Amazon SNS dans le présent guide.

  1. Connectez-vous à la AWS Lambdaconsole.

  2. Dans le panneau de navigation, choisissez Fonctions, puis Créer une fonction.

  3. Sur la page Créer une fonction, procédez de la façon suivante :

    1. Choisissez Parcourir le référentiel d'applications sans serveur, Applications publiques, Afficher les applications qui créent des politiques de rôles ou de ressources IAM personnalisées.

    2. Recherchez fork-event-search-analytics-pipeline et choisissez l'application.

  4. Sur la page fork-event-search-analytics-pipeline, procédez comme suit :

    1. Dans la section Paramètres de l'application, entrez un Nom d'application (par exemple, my-app-search).

      Note

      Pour chaque déploiement, le nom de l'application doit être unique. Si vous réutilisez un nom d'application, le déploiement met à jour uniquement la pile AWS CloudFormation déployée précédemment (au lieu d'en créer une autre).

    2. (Facultatif) Pour DataTransformationFunctionArn, entrez l'ARN de la fonction Lambda utilisée pour transformer les événements entrants. Si vous ne spécifiez pas de valeur, la transformation des données est désactivée.

    3. (Facultatif) Entrez l'un des LogLevelparamètres suivants pour l'exécution de la fonction Lambda de votre application :

      • DEBUG

      • ERROR

      • INFO (default)

      • WARNING

    4. (Facultatif) Pour SearchDomainArn, entrez l'ARN du domaine de OpenSearch service, un cluster qui configure les fonctionnalités de calcul et de stockage nécessaires. Si vous ne spécifiez pas de valeur, un nouveau domaine est créé avec la configuration par défaut.

    5. Pour TopicArn, entrez l'ARN de la rubrique Amazon SNS à laquelle cette instance du pipeline de fork doit être abonnée.

    6. Pour SearchIndexName, entrez le nom de l'index des OpenSearch services pour la recherche et l'analyse des événements.

      Note

      Les quotas suivants s'appliquent aux noms d'index :

      • Vous ne pouvez pas inclure de majuscules

      • Vous ne pouvez pas inclure les caractères suivants : \ / * ? " < > | ` , #

      • Vous ne pouvez pas commencer par les caractères suivants : - + _

      • Vous ne pouvez pas utiliser : . ..

      • Vous ne pouvez pas utiliser plus de 80 caractères

      • Vous ne pouvez pas utiliser plus de 255 octets

      • Ne peut pas contenir de deux-points (depuis OpenSearch Service 7.0)

    7. (Facultatif) Entrez l'un des SearchIndexRotationPeriodparamètres suivants pour la période de rotation de l'indice de OpenSearch service :

      • NoRotation (default)

      • OneDay

      • OneHour

      • OneMonth

      • OneWeek

      La rotation d'index ajoute un horodatage au nom de l'index, ce qui facilite l'expiration des anciennes données.

    8. Pour SearchTypeName, entrez le nom du type de OpenSearch service pour organiser les événements dans un index.

      Note

      • OpenSearch Les noms de type de service peuvent contenir n'importe quel caractère (à l'exception des octets nuls), mais ils ne peuvent pas commencer par_.

      • Pour le OpenSearch Service 6.x, il ne peut y avoir qu'un seul type par index. Si vous spécifiez un nouveau type pour un index existant qui possède déjà un autre type, Firehose renvoie une erreur d'exécution.

    9. (Facultatif) Pour StreamBufferingIntervalInSecondset StreamBufferingSizeInMBs, entrez les valeurs permettant de configurer la mise en mémoire tampon des événements entrants. Si vous n'entrez aucune valeur, 300 secondes et 5 Mo sont utilisés.

    10. (Facultatif) Entrez l'un des StreamCompressionFormatparamètres suivants pour compresser les événements entrants :

      • GZIP

      • SNAPPY

      • UNCOMPRESSED (default)

      • ZIP

    11. (Facultatif) Pour StreamPrefix, entrez le préfixe de chaîne pour nommer les fichiers stockés dans le compartiment de lettres mortes S3. Si vous ne spécifiez pas de valeur, aucun préfixe n'est utilisé.

    12. (Facultatif) Pour StreamRetryDurationInSecons, entrez la durée des nouvelles tentatives dans les cas où Firehose ne parvient pas à indexer les événements dans OpenSearch l'index des services. Si vous ne spécifiez pas de valeur, 300 secondes seront utilisées.

    13. (Facultatif) Pour SubscriptionFilterPolicy, entrez la politique de filtrage des abonnements Amazon SNS, au format JSON, à utiliser pour filtrer les événements entrants. La politique de filtrage détermine quels événements sont indexés dans l'index des OpenSearch services. Si vous ne spécifiez pas de valeur, aucun filtrage n'est utilisé (tous les événements sont indexés).

    14. Choisissez Je comprends que cette application crée des rôles IAM et des politiques de ressources personnalisés, et déploie des applications imbriquées., puis choisissez Déployer.

Sur la my-app-searchpage État du déploiement pour, Lambda affiche l'état Votre application est en cours de déploiement.

Dans la section Ressources, AWS CloudFormation commence à créer la pile et affiche l'état CREATE_IN_PROGRESS pour chaque ressource. Lorsque le processus est terminé, AWS CloudFormation affiche l'état CREATE_COMPLETE.

Une fois le déploiement terminé, Lambda affiche l'état Votre application a été déployée.

Les messages publiés sur votre rubrique Amazon SNS sont indexés automatiquement dans l'index des OpenSearch services fourni par le pipeline Event Search and Analytics. Si le pipeline ne peut pas indexer un événement, il le stocke dans un compartiment S3 de lettres mortes.