Panoramica dell'estensione Microsoft Azure

NOTE
Adobe Experience Platform Launch è stato ridefinito come suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

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 dall'Edge Network Adobe Experience Platform a Azure per l'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 Experience Platform e seleziona Inoltro eventi 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, seleziona Estensioni nel menu di navigazione a sinistra, quindi seleziona la scheda Catalogo. Cerca la scheda Microsoft Azure, quindi seleziona Installa.

Pulsante Installa 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 si selezionano le azioni per la regola, selezionare Microsoft Azure per l'estensione, quindi selezionare Invia dati a hub eventi per il tipo di azione.

Tipo di azione Invia dati a hub eventi 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 Invia dati a hub eventi visualizzato nellinterfaccia utente.

Dettagli hub eventi

Input
Descrizione
Spazio dei nomi
Nome dello spazio dei nomi Event Hubs creato durante la configurazione dell'hub eventi.
Nome
Nome dell’hub eventi.
Nome regola di autorizzazione SAS
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.
Chiave di accesso SAS
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.
ID partizione
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, seleziona Mantieni modifiche per aggiungere l'azione alla configurazione della regola. Una volta soddisfatta la regola, selezionare Salva nella libreria.

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, crea un elemento dati di tipo Segreto e seleziona il segreto Event Hubs dall'elenco. Una volta configurato l'elemento dati segreto, è possibile fare riferimento a tale elemento nel campo Chiave di accesso SAS.

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