Lägga till en händelsekälla för händelsehubben i din Azure Time Series Insights-miljö
Kommentar
Time Series Insights-tjänsten dras tillbaka den 7 juli 2024. Överväg att migrera befintliga miljöer till alternativa lösningar så snart som möjligt. Mer information om utfasning och migrering finns i vår dokumentation.
Den här artikeln beskriver hur du använder Azure-portalen för att lägga till en händelsekälla som läser data från Azure Event Hubs till din Azure Time Series Insights-miljö.
Kommentar
Stegen som beskrivs i den här artikeln gäller både för Azure Time Series Insights Gen 1- och Azure Time Series Insights Gen 2-miljöer.
Förutsättningar
- Skapa en Azure Time Series Insights-miljö enligt beskrivningen i Skapa en Azure Time Series Insights-miljö.
- Skapa en händelsehubb. Läs Skapa ett Event Hubs-namnområde och en händelsehubb med hjälp av Azure-portalen.
- Händelsehubben måste ha aktiva meddelandehändelser skickade till sig. Lär dig hur du skickar händelser till Azure Event Hubs med hjälp av .NET Framework.
- Skapa en dedikerad konsumentgrupp i händelsehubben som Azure Time Series Insights-miljön kan använda från. Varje Azure Time Series Insights-händelsekälla måste ha en egen dedikerad konsumentgrupp som inte delas med någon annan konsument. Om flera läsare använder händelser från samma konsumentgrupp kommer alla läsare sannolikt att uppvisa fel. Det finns en gräns på 20 konsumentgrupper per händelsehubb. Mer information finns i programmeringsguiden för Event Hubs.
Lägga till en konsumentgrupp i händelsehubben
Program använder konsumentgrupper för att hämta data från Azure Event Hubs. Om du vill läsa data på ett tillförlitligt sätt från din händelsehubb tillhandahåller du en dedikerad konsumentgrupp som endast används av den här Azure Time Series Insights-miljön.
Så här lägger du till en ny konsumentgrupp i händelsehubben:
I Azure-portalen letar du upp och öppnar din händelsehubbinstans från fönstret Översikt i händelsehubbens namnområde. Välj Entiteter > Event Hubs eller leta reda på din instans under Namn.
I din händelsehubbinstans väljer du Entiteter > Konsumentgrupper. Välj sedan + Konsumentgrupp för att lägga till en ny konsumentgrupp.
Annars väljer du en befintlig konsumentgrupp och går vidare till nästa avsnitt.
På sidan Konsumentgrupper anger du ett nytt unikt värde för Namn. Använd samma namn när du skapar en ny händelsekälla i Azure Time Series Insights-miljön.
Välj Skapa.
Lägga till en ny händelsekälla
Logga in på Azure-portalen.
Leta upp din befintliga Azure Time Series Insights-miljö. I den vänstra menyn väljer du Alla resurser och sedan din Azure Time Series Insights-miljö.
Välj Händelsekällor och sedan Lägg till.
Ange ett värde för händelsekällans namn som är unikt för den här Azure Time Series Insights-miljön, till exempel
Contoso-TSI-Gen 1-Event-Hub-ES.För Källa väljer du Händelsehubb.
Välj lämpliga värden för importalternativet:
Om du har en befintlig händelsehubb i en av dina prenumerationer väljer du Använd händelsehubb från tillgängliga prenumerationer. Det här alternativet är den enklaste metoden.
I följande tabell beskrivs de egenskaper som krävs för alternativet Använd händelsehubb från tillgängliga prenumerationer :
Property Beskrivning Prenumeration Prenumerationen som den önskade händelsehubbens instans och namnområde tillhör. Namnområde för händelsehubb Händelsehubbens namnområde som den önskade händelsehubbinstansen tillhör. Namn på händelsehubb Namnet på den önskade händelsehubbens instans. Principvärde för Händelsehubb Välj önskad princip för delad åtkomst. Du kan skapa principen för delad åtkomst på fliken Konfigurera händelsehubb. Varje princip för delad åtkomst har ett namn, behörigheter som du anger och åtkomstnycklar. Principen för delad åtkomst för händelsekällan måste ha läsbehörighet . Principnyckel för Händelsehubb Förifylld från det valda principvärdet för händelsehubben. Om händelsehubben är extern för dina prenumerationer eller om du vill välja avancerade alternativ väljer du Ange Inställningar för händelsehubb manuellt.
I följande tabell beskrivs de egenskaper som krävs för alternativet Ange händelsehubbinställningar manuellt :
Property beskrivning Prenumerations-ID:t Prenumerationen som den önskade händelsehubbens instans och namnområde tillhör. Resursgrupp Resursgruppen som den önskade händelsehubbens instans och namnområde tillhör. Namnområde för händelsehubb Händelsehubbens namnområde som den önskade händelsehubbinstansen tillhör. Namn på händelsehubb Namnet på den önskade händelsehubbens instans. Principvärde för Händelsehubb Välj önskad princip för delad åtkomst. Du kan skapa principen för delad åtkomst på fliken Konfigurera händelsehubb. Varje princip för delad åtkomst har ett namn, behörigheter som du anger och åtkomstnycklar. Principen för delad åtkomst för händelsekällan måste ha läsbehörighet . Principnyckel för Händelsehubb Den delade åtkomstnyckel som används för att autentisera åtkomst till Service Bus-namnområdet. Ange den primära eller sekundära nyckeln här. Båda alternativen delar följande konfigurationsalternativ:
Property beskrivning Konsumentgrupp för händelsehubb Konsumentgruppen som läser händelser från händelsehubben. Vi rekommenderar starkt att du använder en dedikerad konsumentgrupp för din händelsekälla. Format för serialisering av händelser JSON är för närvarande det enda tillgängliga serialiseringsformatet. Händelsemeddelanden måste vara i det här formatet eller så går det inte att läsa data. Egenskapsnamn för tidsstämpeln För att fastställa det här värdet måste du förstå meddelandeformatet för de meddelandedata som skickas till händelsehubben. Det här värdet är namnet på den specifika händelseegenskapen i meddelandedata som du vill använda som händelsetidsstämpel. Värdet är skiftlägeskänsligt. Om den lämnas tom används händelsens tid i händelsekällan som tidsstämpel för händelsen.
Lägg till det dedikerade konsumentgruppnamnet för Azure Time Series Insights som du lade till i din händelsehubb.
Välj Skapa.
När händelsekällan har skapats börjar Azure Time Series Insights automatiskt strömma data till din miljö.
Nästa steg
Definiera dataåtkomstprinciper för att skydda data.
Skicka händelser till händelsekällan.