Lägga till en IoT Hub-händelsekälla i din Azure Time Series Insight-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 IoT Hub i din Azure Time Series Insights-miljö.

Kommentar

Anvisningarna i den här artikeln gäller både för Azure Time Series Insights Gen 1 och för Azure Time Series Insight Gen 2-miljöer.

Förutsättningar

• Skapa en Azure Time Series Insights-miljö.
• Skapa en IoT-hubb med hjälp av Azure-portalen.
• IoT-hubben måste ha aktiva meddelandehändelser som skickas in.
• Skapa en dedikerad konsumentgrupp i IoT-hubben för Azure Time Series Insight-miljön att använda från. Varje Azure Time Series Insight-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. Mer information finns i utvecklarguiden för Azure IoT Hub.

Lägga till en konsumentgrupp i din IoT-hubb

Program använder konsumentgrupper för att hämta data från Azure IoT Hub. Om du vill läsa data på ett tillförlitligt sätt från din IoT-hubb tillhandahåller du en dedikerad konsumentgrupp som endast används av den här Azure Time Series Insight-miljön.

Så här lägger du till en ny konsumentgrupp i din IoT-hubb:

1. I Azure-portalen letar du upp och öppnar din IoT-hubb.

2. Under Inställningar väljer du Inbyggda slutpunkter och sedan slutpunkten Händelser.

   

3. Under Konsumentgrupper anger du ett unikt namn för konsumentgruppen. Använd samma namn i Azure Time Series Insight-miljön när du skapar en ny händelsekälla.

4. Välj Spara.

Lägga till en ny händelsekälla

1. Logga in på Azure-portalen.

2. Välj Alla resurser i menyn till vänster. Välj din Azure Time Series Insight-miljö.

3. Under Inställningar väljer du Händelsekällor och sedan Lägg till.

   

4. I fönstret Ny händelsekälla anger du för Händelsekällans namn ett namn som är unikt för den här Azure Time Series Insight-miljön. Ange till exempel event-stream.

5. För Källa väljer du IoT Hub.

6. Välj ett värde för importalternativet:

   • Om du redan har en IoT-hubb i en av dina prenumerationer väljer du Använd IoT Hub 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 IoT Hub från tillgängliga prenumerationer :

     

     Property	Beskrivning
     Prenumeration	Prenumerationen som den önskade iot-hubben tillhör.
     Namn på IoT-hubb	Namnet på den valda iot-hubben.
     Principnamn för IoT Hub	Välj principen för delad åtkomst. Du hittar principen för delad åtkomst på fliken Inställningar för IoT Hub. 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 behörigheter för tjänstanslutning .
     Principnyckel för IoT Hub	Nyckeln är ifylld i förväg.

   • Om IoT-hubben är extern för dina prenumerationer eller om du vill välja avancerade alternativ väljer du Ange IoT Hub-inställningar manuellt.

     I följande tabell beskrivs de egenskaper som krävs för inställningarna för Ange IoT Hub manuellt:

     Property	beskrivning
     Prenumerations-ID:t	Prenumerationen som den önskade iot-hubben tillhör.
     Resursgrupp	Resursgruppens namn där IoT-hubben skapades.
     Namn på IoT-hubb	Namnet på din IoT-hubb. När du skapade din IoT-hubb angav du ett namn för IoT-hubben.
     Principnamn för IoT Hub	Principen för delad åtkomst. Du kan skapa principen för delad åtkomst på fliken inställningar för IoT Hub. 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 behörigheter för tjänstanslutning .
     Principnyckel för IoT Hub	Den delade åtkomstnyckel som används för att autentisera åtkomst till Azure 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 IoT Hub	Konsumentgruppen som läser händelser från IoT-hubben. 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ändelsemeddelandena måste vara i det här formatet eller så kan inga data läsas.
     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 IoT-hubben. 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.

7. Lägg till det dedikerade Azure Time Series Insight-konsumentgruppnamnet som du lade till i din IoT-hubb.

8. Välj Skapa.

9. När du har skapat händelsekällan börjar Azure Time Series Insight 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.

• Få åtkomst till din miljö i Azure Time Series Insight Explorer.