Översikt över tillägget Microsoft Azure

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. I följande dokument finns en konsoliderad referens till de ändrade terminologin.

I Microsoft Azure är Event Hubs en mycket skalbar datainpressningstjänst i realtid som gör att du kan bearbeta och analysera den enorma mängd data som produceras av dina anslutna enheter och program. När data har samlats in i ett händelsehubb kan de omformas och lagras med hjälp av en realtidsanalysleverantör eller batch-/lagringsadaptrar.

Tillägget Microsoft Azure Vidarebefordraanvänder Event Hubs för att skicka händelser från Adobe Experience Platform Edge Network till Azure för vidare bearbetning. Den här guiden beskriver hur du installerar tillägget och använder dess funktioner i en regel för vidarebefordran av händelser.

Förhandskrav

För att kunna använda det här tillägget måste du ha ett giltigt Azure-konto med åtkomst till Event Hubs. Du måste också skapa ett händelsehubb med hjälp av Azure portalen innan du följer stegen nedan.

Installera tillägget

Om du vill installera Microsoft-tillägget Azure går du till användargränssnittet för datainsamlingen eller användargränssnittet för Experience Platform och väljer Event Forwarding i den vänstra navigeringen. Här väljer du en egenskap som tillägget ska läggas till i eller skapar en ny egenskap i stället.

När du har markerat eller skapat den önskade egenskapen väljer du Extensions i den vänstra navigeringen och väljer sedan fliken Catalog. Sök efter kortet Microsoft Azure och välj sedan Install.

Knappen Install som väljs för tillägget Microsoft Azure i användargränssnittet för datainsamling.

Eftersom tillägget inte har några konfigurationsegenskaper läggs det omedelbart till i listan över installerade tillägg. Du kan nu börja använda åtgärdstyperna Event Hub när du konfigurerar regler för vidarebefordran av händelser.

Konfigurera en regel för vidarebefordran av händelser rule

Börja skapa en ny regel för vidarebefordring av händelser och konfigurera villkoren efter behov. När du väljer åtgärder för regeln väljer du Microsoft Azure som tillägg och sedan Send Data to Event Hubs som åtgärdstyp.

Åtgärdstypen Send Data to Event Hubs som väljs för en regel i användargränssnittet för datainsamling.

Den högra panelen uppdateras och visar konfigurationsalternativ för hur data ska skickas. Du måste tilldela dataelement till de olika egenskaper som representerar din Event Hub-konfiguration.

Konfigurationsalternativen för åtgärdstypen Send Data to Event Hubs som visas i gränssnittet.

Event Hub Details

Indata
Beskrivning
Namespace
Namnet på det Event Hubs-namnområde som du skapade när händelsehubbenkonfigurerades.
Name
Namnet på händelsehubben.
SAS Authorization Rule Name
Namnet på auktoriseringsregeln för delad åtkomst för hela Event Hubs-namnområdet eller den specifika händelsehubbsinstansinstansen som du vill skicka data till. Mer information finns i bilagan om att erhålla SAS-auktoriseringsvärden.
SAS Access Key
Den primära nyckeln för auktoriseringsregeln för delad åtkomst för hela Event Hubs-namnområdet eller den specifika händelsehubbsinstansinstansen som du vill skicka data till. Mer information finns i bilagan om att erhålla SAS-auktoriseringsvärden.
Partition ID
Med Event Hubs kan du skicka händelser direkt till specifika partitioner. Om du vill använda den här funktionen anger du ID:t för den partition som du vill ta emot händelserna.

Data

Indata
Beskrivning
Payload
Det här fältet innehåller de data som kommer att vidarebefordras till Event Hubs. Data kan vara ett JSON-objekt, en sträng eller ett dataelement.

När du är klar väljer du Keep Changes för att lägga till åtgärden i regelkonfigurationen. När du är nöjd med regeln väljer du Save to Library.

Publicera slutligen en ny händelse som vidarebefordrar build för att aktivera ändringarna i biblioteket.

Nästa steg

I den här guiden beskrivs hur du skickar data till Event Hubs med hjälp av tillägget Microsoft Azure för vidarebefordran av händelser. Mer information om funktioner för att vidarebefordra händelser i Experience Platform finns i översikten över vidarebefordran av händelser.

Bilaga: Hämta SAS-auktoriseringsvärden sas

Externa program beviljas åtkomst till Event Hubs via delade åtkomstsignaturer (SAS). Varje Event Hubs-namnrymd och händelsehubbsinstans tilldelas automatiskt en standard-SAS-auktoriseringsregel när den skapas, men du kan också skapa ytterligare principer för varje resurs om du vill.

När konfigurerar en regel för vidarebefordran av händelser med tillägget Azure måste du ange namnet och primärnyckeln för auktoriseringsregeln som styr det namnområde eller den specifika händelsehubb som du vill skicka data till. Mer information om hur du hämtar dessa värden från portalen Azure finns i följande avsnitt i dokumentationen för Azure:

När du har de obligatoriska värdena kan auktoriseringsregelnamnet anges direkt som en sträng i config-indata eller så kan du skapa ett dataelement av strängtyp för att referera till det i stället. Primärnyckeln måste dock först finnas inuti en händelsevidarebefordringshemlighet innan den kan anges i regelkonfigurationen för att skydda din datasäkerhet.

I gränssnittet för vidarebefordran av händelser skapar en ny hemlighet och väljer Token som hemlig typ. Ange primärnyckeln som du kopierade tidigare för själva tokenvärdet. När du har skapat hemligheten skapar du ett dataelement med typen Secret och väljer Event Hubs-hemligheten i listan. När det hemliga dataelementet har konfigurerats kan du referera till det dataelementet i fältet SAS Access Key.

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