Présentation de l’extension Microsoft Azure

NOTE
Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

Dans Microsoft Azure, Event Hubs est un service d’entrée de données en temps réel hautement évolutif qui vous permet de traiter et d’analyser les quantités massives de données produites par vos appareils et applications connectés. Une fois que les données sont collectées dans un centre d’événements, elles peuvent être transformées et stockées à l’aide de n’importe quel fournisseur d’analyses en temps réel ou de n’importe quel adapteur de traitement par lot/stockage.

L’extension Microsoft Azure de transfert d’événement exploite Event Hubs pour envoyer des événements de l’Edge Network Adobe Experience Platform vers Azure en vue d’un traitement ultérieur. Ce guide explique comment installer l’extension et utiliser ses fonctionnalités dans une règle de transfert d’événement.

Conditions préalables

Pour utiliser cette extension, vous devez disposer d’un compte Azure valide ayant accès à Event Hubs. Vous devez également créer un hub d’événements à l’aide du Azure portal avant de suivre les étapes ci-dessous.

Installation l’extension

Pour installer l’extension Microsoft Azure, accédez à l’interface utilisateur de collecte de données ou à l’interface utilisateur Experience Platform et sélectionnez Transfert d’événement dans le volet de navigation de gauche. À partir de là, sélectionnez une propriété à laquelle ajouter l’extension ou créez une propriété à la place.

Une fois que vous avez sélectionné ou créé la propriété souhaitée, sélectionnez Extensions dans le volet de navigation de gauche, puis sélectionnez l’onglet Catalogue . Recherchez la carte Microsoft Azure , puis sélectionnez Installer.

Bouton Installer sélectionné pour l’extension Microsoft Azure dans l’interface utilisateur de la collecte de données.

L’extension n’ayant aucune propriété de configuration, elle est immédiatement ajoutée à la liste des extensions installées. Vous pouvez maintenant commencer à utiliser les types d’action Event Hub lors de la configuration des règles de transfert d’événement.

Configurer une règle de transfert d’événement rule

Commencez à créer une règle de transfert d’événement et configurez ses conditions selon vos besoins. Lors de la sélection des actions de la règle, sélectionnez Microsoft Azure pour l’extension, puis Envoyer les données aux centres d’événements pour le type d’action.

Le type d’action Envoyer des données aux centres d’événements sélectionné pour une règle dans l’interface utilisateur de collecte de données.

Le panneau de droite se met à jour afin d’afficher les options de configuration permettant d’envoyer les données. Plus précisément, vous devez affecter des éléments de données aux différentes propriétés qui représentent votre configuration Event Hub.

Les options de configuration pour le type d’action Send Data to Event Hubs affiché dans l’interface utilisateur.

Détails du hub d’événements

Entrée
Description
Espace de noms
Nom de l’espace de noms Event Hubs que vous avez créé lors de la configuration du hub d’événements.
Nom
Nom du centre d’événements.
Nom de la règle d’autorisation SAS
Nom de la règle d’autorisation d’accès partagée pour l’ensemble de votre espace de noms Event Hubs ou l’instance spécifique du hub d’événements à laquelle vous souhaitez envoyer des données. Pour plus d’informations, reportez-vous à la section de l’annexe sur l’ obtention des valeurs d’autorisation SAS .
Clé d’accès SAS
La clé primaire de la règle d’autorisation d’accès partagée pour l’ensemble de votre espace de noms Event Hubs ou l’instance spécifique du hub d’événements à laquelle vous souhaitez envoyer des données. Pour plus d’informations, reportez-vous à la section de l’annexe sur l’ obtention des valeurs d’autorisation SAS .
ID de partition
Event Hubs vous permet d' envoyer des événements directement à des partitions spécifiques. Pour tirer parti de cette fonctionnalité, fournissez l’identifiant de la partition que vous souhaitez recevoir les événements.

Data (Données)

Entrée
Description
Charge utile
Ce champ contient les données qui seront transférées vers le Event Hubs. Les données peuvent être un objet JSON, une chaîne ou un élément de données.

Lorsque vous avez terminé, sélectionnez Conserver les modifications pour ajouter l’action à la configuration de la règle. Lorsque la règle vous satisfait, sélectionnez Enregistrer dans la bibliothèque.

Enfin, publiez un nouveau transfert d’événement build pour activer les modifications apportées à la bibliothèque.

Étapes suivantes

Ce guide explique comment envoyer des données à Event Hubs à l’aide de l’extension de transfert d’événement Microsoft Azure. Pour plus d’informations sur les fonctionnalités de transfert d’événement en Experience Platform, consultez la présentation du transfert d’événement.

Annexe : Obtention des valeurs d’autorisation SAS sas

Les applications externes se voient accorder l’accès à Event Hubs par le biais de signatures d’accès partagé (SAS). Chaque instance Event Hubs d’espace de noms et de hub d’événements comporte une règle d’autorisation SAS par défaut automatiquement attribuée lors de la création, mais vous pouvez également créer des stratégies supplémentaires pour chaque ressource, si vous le souhaitez.

Lors de la configuration d'une règle de transfert d'événement à l'aide de l'extension Azure, vous devez fournir le nom et la clé primaire de la règle d'autorisation régissant l'espace de noms ou le centre d'événements spécifique auquel vous souhaitez envoyer des données. Pour plus d’informations sur la manière d’obtenir ces valeurs à partir du portail Azure, reportez-vous aux sections suivantes de la documentation Azure :

Une fois que vous disposez des valeurs requises, le nom de la règle d’autorisation peut être fourni directement sous la forme d’une chaîne dans l’entrée de configuration ou vous pouvez créer un élément de données de type chaîne pour le référencer à la place. Toutefois, la clé primaire doit d’abord être contenue dans un secret de transfert d’événement avant de pouvoir être fournie dans la configuration de la règle afin de protéger votre sécurité des données.

Dans l’interface utilisateur du transfert d’événement, créez un nouveau secret et sélectionnez Jeton comme type de secret. Pour la valeur de jeton elle-même, fournissez la clé primaire que vous avez copiée précédemment. Après avoir créé le secret, créez un élément de données de type Secret et sélectionnez le secret Event Hubs dans la liste. Une fois l’élément de données secret configuré, vous pouvez référencer cet élément de données dans le champ Clé d’accès SAS .

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743