Lägga till en IoT Hub-händelsekälla i Azure Time Series Insight-miljön

Den här artikeln beskriver hur du använder Azure Portal för att lägga till en händelsekälla som läser data från Azure IoT Hub till din Azure Time Series Insights miljö.

Anteckning

Anvisningarna i den här artikeln gäller både för Azure Time Series Insights Gen 1 och 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 Portal.
  • IoT-hubben måste ha aktiva meddelandehändelser som skickas.
  • Skapa en dedikerad konsumentgrupp i IoT Hub som Azure Time Series Insight-miljön kan 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 troligen att uppvisa fel. Mer information finns i Azure IoT Hub utvecklarhandbok.

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 från din IoT-hubb på ett tillförlitligt sätt 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 Portaldu och öppnar din IoT-hubb.

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

    På sidan Inbyggda slutpunkter väljer du knappen 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.

    Välj Händelsekällor och välj sedan knappen Lägg till

  4. I fönstret Ny händelsekälla anger du ett namn som är unikt för den här Azure Time Series Insight-miljön för Namn på händelsekälla. 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 det enklaste alternativet.

      Välj alternativ i fönstret Ny händelsekälla

    • I följande tabell beskrivs de egenskaper som krävs för alternativet Använd IoT Hub från tillgängliga prenumerationer:

      Fönstret Ny händelsekälla – Egenskaper som ska anges i alternativet Använd IoT Hub från tillgängliga prenumerationer

      Egenskap Beskrivning
      Prenumeration Den prenumeration som önskad iot-hubb tillhör.
      Namn på IoT-hubb Namnet på den valda iot-hubben.
      Namn på IoT-hubbprincip 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örighet för tjänståtkomst.
      Principnyckel för IoT Hub Nyckeln är förindelad.
    • 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 obligatoriska egenskaperna för ange IoT Hub manuellt:

      Egenskap Beskrivning
      Prenumerations-ID:t Den prenumeration som önskad iot-hubb tillhör.
      Resursgrupp Resursgruppens namn som IoT-hubben skapades i.
      Namn på IoT-hubb Namnet på din IoT-hubb. När du skapade din IoT-hubb angav du ett namn för IoT-hubben.
      Namn på IoT-hubbprincip 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örighet för tjänståtkomst.
      Principnyckel för IoT Hub Den delade åtkomstnyckel som används för att autentisera åtkomsten till Azure Service Bus namnområdet. Ange den primära eller sekundära nyckeln här.
    • Båda alternativen har följande konfigurationsalternativ:

      Egenskap 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.
      Händelseserialiseringsformat JSON är för närvarande det enda tillgängliga serialiseringsformatet. Händelsemeddelandena måste ha det här formatet, annars kan inga data läsas.
      Egenskapsnamn för tidsstämpel För att fastställa det här värdet måste du förstå meddelandeformatet för meddelandedata som skickas till IoT-hubben. Det här värdet är namnet på den specifika händelseegenskapen i de meddelandedata som du vill använda som händelsetidsstämpel. Värdet är fallkänsligt. Om det lämnas tomt används händelsekötiden i händelsekällan som händelsetidsstämpel.
  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 att strömma data till din miljö.

Nästa steg