Panoramica dell'estensione Microsoft Azure

In Microsoft Azure, Event Hubs è un servizio di immissione dati altamente scalabile e in tempo reale che consente di elaborare e analizzare le grandi quantità di dati prodotti dai dispositivi e dalle applicazioni connessi. Una volta raccolti i dati in un hub eventi, questi possono essere trasformati e memorizzati utilizzando qualsiasi provider di analisi in tempo reale o adattatori di batch/archiviazione.

L'estensione Microsoft Azure event forwarding sfrutta Event Hubs per inviare eventi da Adobe Experience Platform Edge Network a Azure per ulteriore elaborazione. Questa guida illustra come installare l’estensione e utilizzarne le funzionalità in una regola di inoltro degli eventi.

Prerequisiti

Per utilizzare questa estensione, è necessario disporre di un account Azure valido con accesso a Event Hubs. Devi anche creare un hub eventi utilizzando il Azure portale prima di seguire i passaggi seguenti.

Installare l’estensione

Per installare l'estensione Microsoft Azure, passa all'interfaccia utente di Data Collection o all'interfaccia utente di Experience Platform e seleziona Event Forwarding dal menu di navigazione a sinistra. Da qui, seleziona una proprietà a cui aggiungere l’estensione o creane una nuova.

Dopo aver selezionato o creato la proprietà desiderata, selezionare Extensions nel menu di navigazione a sinistra, quindi selezionare la scheda Catalog. Cerca la scheda Microsoft Azure, quindi seleziona Install.

Pulsante Install selezionato per lestensione Microsoft Azure nellinterfaccia utente di Data Collection.

Poiché l'estensione non dispone di proprietà di configurazione, viene aggiunta immediatamente all'elenco delle estensioni installate. È ora possibile iniziare a utilizzare i tipi di azione Event Hub durante la configurazione delle regole di inoltro degli eventi.

Configurare una regola di inoltro degli eventi rule

Inizia a creare una nuova regola di inoltro degli eventi e configurane le condizioni come desiderato. Quando selezioni le azioni per la regola, seleziona Microsoft Azure per l'estensione, quindi seleziona Send Data to Event Hubs per il tipo di azione.

Tipo di azione Send Data to Event Hubs selezionato per una regola nellinterfaccia utente di Data Collection.

Il pannello a destra si aggiorna per mostrare le opzioni di configurazione per la modalità di invio dei dati. In particolare, devi assegnare elementi dati alle varie proprietà che rappresentano la tua configurazione di Event Hub.

Opzioni di configurazione per il tipo di azione Send Data to Event Hubs visualizzato nellinterfaccia utente.

Event Hub Details

Input
Descrizione
Namespace
Nome dello spazio dei nomi Event Hubs creato durante la configurazione dell'hub eventi.
Name
Nome dell’hub eventi.
SAS Authorization Rule Name
Nome della regola di autorizzazione di accesso condiviso per l'intero spazio dei nomi Event Hubs o per l'istanza hub eventi specifica a cui si desidera inviare i dati. Per ulteriori informazioni, vedere la sezione dell'appendice su ottenimento dei valori di autorizzazione SAS.
SAS Access Key
Chiave primaria della regola di autorizzazione di accesso condiviso per l'intero spazio dei nomi Event Hubs o per l'istanza hub eventi specifica a cui si desidera inviare i dati. Per ulteriori informazioni, vedere la sezione dell'appendice su ottenimento dei valori di autorizzazione SAS.
Partition ID
Event Hubs consente di inviare eventi direttamente a partizioni specifiche. Per sfruttare questa funzione, fornisci l’ID della partizione a cui desideri inviare gli eventi.

Dati

Input
Descrizione
Payload
Questo campo contiene i dati che verranno inoltrati a Event Hubs. I dati possono essere un oggetto JSON, una stringa o un elemento dati.

Al termine, selezionare Keep Changes per aggiungere l'azione alla configurazione della regola. Quando si è soddisfatti della regola, selezionare Save to Library.

Infine, pubblica un nuovo evento con inoltro di build per abilitare le modifiche alla libreria.

Passaggi successivi

Questa guida illustra come inviare dati a Event Hubs utilizzando l'estensione di inoltro eventi Microsoft Azure. Per ulteriori informazioni sulle funzionalità di inoltro degli eventi in Experience Platform, consulta la panoramica sull'inoltro degli eventi.

Appendice: ottenere i valori di autorizzazione SAS sas

Alle applicazioni esterne viene concesso l'accesso a Event Hubs tramite firme di accesso condiviso (SAS). Ogni istanza hub eventi e spazio dei nomi Event Hubs dispone di una regola di autorizzazione SAS predefinita assegnata automaticamente al momento della creazione, ma è anche possibile creare criteri aggiuntivi per ogni risorsa.

Quando configuri una regola di inoltro eventi utilizzando l'estensione Azure, devi fornire il nome e la chiave primaria per la regola di autorizzazione che disciplina lo spazio dei nomi o l'hub eventi specifico a cui desideri inviare i dati. Per informazioni dettagliate su come ottenere questi valori dal portale Azure, fare riferimento alle sezioni seguenti nella documentazione di Azure:

Una volta ottenuti i valori richiesti, il nome della regola di autorizzazione può essere fornito direttamente come stringa nell’input di configurazione oppure puoi creare un elemento dati di tipo stringa a cui fare riferimento. La chiave primaria, tuttavia, deve prima essere contenuta all’interno di un segreto di inoltro degli eventi prima di poter essere fornita nella configurazione della regola per proteggere la sicurezza dei dati.

Nell'interfaccia utente per l'inoltro degli eventi, crea un nuovo segreto e seleziona Token come tipo segreto. Per il valore del token stesso, specifica la chiave primaria copiata in precedenza. Dopo aver creato il segreto, creare un elemento dati con il tipo Secret e selezionare il segreto Event Hubs dall'elenco. Una volta configurato l'elemento dati segreto, è possibile fare riferimento a tale elemento dati nel campo SAS Access Key.

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