Exportera IoT-data till molnmål med hjälp av dataexport

Om du inte har ett befintligt namnområde Event Hubs exportera till följer du dessa steg:

1. Skapa en Event Hubs namnrymd i Azure Portal. Du kan läsa mer i Azure Event Hubs dokument.

2. Skapa en händelsehubb i Event Hubs namnområdet. Gå till ditt namnområde och välj + Händelsehubb längst upp för att skapa en händelsehubbinstans.

3. Generera en nyckel som ska användas när du ska konfigurera din dataexport i IoT Central:

   • Välj den händelsehubbinstans som du skapade.
   • Välj Inställningar > principer för delad åtkomst.
   • Skapa en ny nyckel eller välj en befintlig nyckel som har behörigheten Skicka.
   • Kopiera antingen den primära eller sekundära anslutningssträngen. Du använder den här anslutningssträngen för att konfigurera ett nytt mål i IoT Central.
   • Du kan också generera en anslutningssträng för hela Event Hubs namnområdet:
     1. Gå till Event Hubs namnrymden i Azure Portal.
     2. Under Inställningar väljer du Principer för delad åtkomst
     3. Skapa en ny nyckel eller välj en befintlig nyckel som har behörigheten Skicka.
     4. Kopiera antingen den primära eller sekundära anslutningssträngen

Om du inte har ett befintligt namnområde Event Hubs exportera till följer du dessa steg:

1. Skapa en Event Hubs namnrymd i Azure Portal. Du kan läsa mer i Azure Event Hubs dokument.

2. Skapa en händelsehubb i Event Hubs namnområdet. Gå till ditt namnområde och välj + Händelsehubb längst upp för att skapa en händelsehubbinstans.

Så här konfigurerar du den hanterade identitet som gör IoT Central program kan exportera data till händelsehubben på ett säkert sätt:

1. I Azure Portalnavigerar du till ditt IoT Central program.

   Tips

   Som standard IoT Central program i IOTC-resursgruppen i din prenumeration.

2. Välj Identitet. På sidan System tilldelad ändrar du sedan statusen till På och väljer sedan Spara.

3. Efter några sekunder aktiveras den system tilldelade hanterade identiteten för IoT Central och du kan välja Azure-rolltilldelningar:

   

4. På sidan Azure-rolltilldelningar väljer du + Lägg till rolltilldelning.

Så här konfigurerar du behörigheterna:

1. På sidan Lägg till rolltilldelning väljer du det omfång och den prenumeration som du vill använda.

   Tips

   Om ditt IoT Central program och händelsehubb finns i samma resursgrupp kan du välja Resursgrupp som omfång och sedan välja resursgruppen.

2. Välj Azure Event Hubs Data Sender som Roll.

3. Välj Spara. Den hanterade identiteten för IoT Central har nu konfigurerats.

Om du vill skydda händelsehubben ytterligare och endast tillåta åtkomst från betrodda tjänster med hanterade identiteter kan du läsa:

• Tillåt åtkomst till Azure Event Hubs med privata slutpunkter
• Betrodda Microsoft-tjänster
• Tillåt åtkomst till Azure Event Hubs-namnområden från specifika virtuella nätverk

Om du inte har ett befintligt namnområde Service Bus exportera till följer du dessa steg:

1. Skapa en Service Bus namnrymd i Azure Portal. Du kan läsa mer i Azure Service Bus docs.

2. Om du vill skapa en kö eller ett ämne att exportera till går du Service Bus namnområdet och väljer + Köa eller + Ämne.

3. Generera en nyckel som ska användas när du ska konfigurera din dataexport i IoT Central:

   • Välj den kö eller det ämne som du skapade.
   • Välj Inställningar/principer för delad åtkomst.
   • Skapa en ny nyckel eller välj en befintlig nyckel som har behörigheten Skicka.
   • Kopiera antingen den primära eller sekundära anslutningssträngen. Du använder den här anslutningssträngen för att konfigurera ett nytt mål i IoT Central.
   • Du kan också generera en anslutningssträng för hela Service Bus namnområdet:
     1. Gå till Service Bus namnrymden i Azure Portal.
     2. Under Inställningar väljer du Principer för delad åtkomst
     3. Skapa en ny nyckel eller välj en befintlig nyckel som har behörigheten Skicka.
     4. Kopiera antingen den primära eller sekundära anslutningssträngen

Om du inte har ett befintligt namnområde Service Bus exportera till följer du dessa steg:

1. Skapa en Service Bus namnrymd i Azure Portal. Du kan läsa mer i Azure Service Bus docs.

2. Om du vill skapa en kö eller ett ämne att exportera till går du Service Bus namnområdet och väljer + Köa eller + Ämne.

Så här konfigurerar du den hanterade identitet som gör IoT Central program kan exportera data till händelsehubben på ett säkert sätt:

1. I Azure Portalnavigerar du till ditt IoT Central program.

   Tips

   Som standard IoT Central program i IOTC-resursgruppen i din prenumeration.

2. Välj Identitet. På sidan System tilldelad ändrar du sedan statusen till På och väljer sedan Spara.

3. Efter några sekunder aktiveras den system tilldelade hanterade identiteten för IoT Central och du kan välja Azure-rolltilldelningar:

   

4. På sidan Azure-rolltilldelningar väljer du + Lägg till rolltilldelning.

Så här konfigurerar du behörigheterna:

1. På sidan Lägg till rolltilldelning väljer du det omfång och den prenumeration som du vill använda.

   Tips

   Om ditt IoT Central program och kö eller ämne finns i samma resursgrupp kan du välja Resursgrupp som omfång och sedan välja resursgruppen.

2. Välj Azure Service Bus Data Sender som Roll.

3. Välj Spara. Den hanterade identiteten för IoT Central har nu konfigurerats.

Om du vill skydda din kö eller ditt ämne ytterligare och endast tillåta åtkomst från betrodda tjänster med hanterade identiteter kan du läsa:

• Tillåt åtkomst till Azure Service Bus-namnområden med privata slutpunkter
• Betrodda Microsoft-tjänster
• Tillåt åtkomst till Azure Service Bus från specifika virtuella nätverk

Om du inte har något befintligt Azure Storage-konto att exportera till följer du dessa steg:

1. Skapa ett nytt lagringskonto i Azure Portal. Du kan lära dig mer om att skapa nya Azure Blob Storage-konton eller Azure Data Lake Storage v2-lagringskonton. Dataexport kan bara skriva data till lagringskonton som stöder blockblobar. I följande lista visas de kända kompatibla lagringskontotyperna:

   Prestandanivå	Kontotyp
   Standard	Generell användning V2
   Standard	Generell användning V1
   Standard	Blob Storage
   Premium	Blockbloblagring

2. Om du vill skapa en container i ditt lagringskonto går du till ditt lagringskonto. Under Blob Service väljer du Bläddra efter blobar. Välj + Container högst upp för att skapa en ny container.

3. Generera en anslutningssträng för ditt lagringskonto genom att gå Inställningar > åtkomstnycklar. Kopiera en av de två anslutningssträngarna.

Om du inte har något befintligt Azure Storage-konto att exportera till följer du dessa steg:

1. Skapa ett nytt lagringskonto i Azure Portal. Du kan lära dig mer om att skapa nya Azure Blob Storage-konton eller Azure Data Lake Storage v2-lagringskonton. Dataexport kan bara skriva data till lagringskonton som stöder blockblobar. I följande lista visas de kända kompatibla lagringskontotyperna:

   Prestandanivå	Kontotyp
   Standard	Generell användning V2
   Standard	Generell användning V1
   Standard	Blob Storage
   Premium	Blockbloblagring

2. Om du vill skapa en container i ditt lagringskonto går du till ditt lagringskonto. Under Blob Service väljer du Bläddra efter blobar. Välj + Container högst upp för att skapa en ny container.

Så här konfigurerar du den hanterade identitet som gör IoT Central program kan exportera data till händelsehubben på ett säkert sätt:

1. I Azure Portalnavigerar du till ditt IoT Central program.

   Tips

   Som standard IoT Central program i IOTC-resursgruppen i din prenumeration.

2. Välj Identitet. På sidan System tilldelad ändrar du sedan statusen till På och väljer sedan Spara.

3. Efter några sekunder aktiveras den system tilldelade hanterade identiteten för IoT Central och du kan välja Azure-rolltilldelningar:

   

4. På sidan Azure-rolltilldelningar väljer du + Lägg till rolltilldelning.

Så här konfigurerar du behörigheterna:

1. På sidan Lägg till rolltilldelning väljer du den prenumeration som du vill använda Storage som omfång. Välj sedan ditt lagringskonto som resurs.

2. Välj Storage Blob Data-deltagare som roll.

3. Välj Spara. Den hanterade identiteten för IoT Central har nu konfigurerats.

   Tips

   Den här rolltilldelningen visas inte i listan på sidan för Azure-rolltilldelningar.

Om du vill skydda blobcontainern ytterligare och endast tillåta åtkomst från betrodda tjänster med hanterade identiteter kan du läsa:

• Använda privata slutpunkter för Azure Storage
• Auktorisera åtkomst till blobdata med hanterade identiteter för Azure-resurser
• Konfigurera brandväggar och virtuella nätverk i Azure Storage

Nu när du har ett mål att exportera dina data till kan du konfigurera dataexport i IoT Central program:

1. Logga in på ditt IoT Central program.

2. I den vänstra rutan väljer du Dataexport.

   Tips

   Om du inte ser Dataexport i det vänstra fönstret har du inte behörighet att konfigurera dataexport i din app. Kontakta en administratör för att konfigurera dataexport.

3. Välj + Ny export.

4. Ange ett visningsnamn för den nya exporten och kontrollera att dataexporten är Aktiverad.

5. Välj vilken typ av data som ska exporteras. I följande tabell visas de typer av dataexport som stöds:

   Datatyp	Beskrivning	Dataformat
   Telemetri	Exportera telemetrimeddelanden från enheter nästan i realtid. Varje exporterat meddelande innehåller det fullständiga innehållet i det ursprungliga enhetsmeddelandet, normaliserat.	Meddelandeformat för telemetri
   Egenskapsändringar	Exportera ändringar av enhets- och molnegenskaper nästan i realtid. För skrivskyddade enhetsegenskaper exporteras ändringar av de rapporterade värdena. För läs- och skrivegenskaper exporteras både rapporterade och önskade värden.	Meddelandeformat för ändring av egenskap
   Enhetsanslutning	Exportera enhetsanslutna och frånkopplade händelser.	Meddelandeformat för enhetsanslutning
   Enhetslivscykel	Exportera registrerade, borttagna, etablerade, aktiverade, inaktiverade, displayNameChanged och deviceTemplateChanged-händelser.	Meddelandeformat för enhetslivscykeländringar
   Livscykel för enhetsmall	Exportera publicerade enhetsmalländringar, inklusive skapade, uppdaterade och borttagna.	Meddelandeformat för ändring av enhetsmallslivscykel

6. Du kan också lägga till filter för att minska mängden data som exporteras. Det finns olika typer av filter för varje dataexporttyp:

   Typ av data	Tillgängliga filter
   Telemetri	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten simuleras Filtrera dataströmmen så att den endast innehåller telemetri som uppfyller filtervillkoren Filtrera dataströmmen så att den endast innehåller telemetri från enheter med egenskaper som matchar filtervillkoren Filtrera dataströmmen så att den endast innehåller telemetri som har meddelandeegenskaper som uppfyller filtervillkoret. Meddelandeegenskaper (även kallade programegenskaper) skickas i en påse med nyckel/värde-par på varje telemetrimeddelande som eventuellt skickas av enheter som använder enhets-SDK:erna. Om du vill skapa ett filter för meddelandeegenskap anger du den nyckel för meddelandeegenskap som du letar efter och anger ett villkor. Endast telemetrimeddelanden med egenskaper som matchar det angivna filtervillkoret exporteras. Läs mer om programegenskaper från IoT Hub dokument
   Egenskapsändringar	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten simuleras Filtrera dataströmmen så att den endast innehåller egenskapsändringar som uppfyller filtervillkoren
   Enhetsanslutning	Filtrera efter enhetsnamn, enhets-ID, enhetsmall, organisationer och om enheten simuleras Filtrera dataströmmen så att den endast innehåller ändringar från enheter med egenskaper som matchar filtervillkoren
   Enhetslivscykel	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten har etablerats, aktiverats eller simulerats Filtrera dataströmmen så att den endast innehåller ändringar från enheter med egenskaper som matchar filtervillkoren
   Livscykel för enhetsmall	Filtrera efter enhetsmall

7. Du kan också utöka exporterade meddelanden med extra nyckel/värde-parmetadata. Följande berikningar är tillgängliga för exporttyperna telemetri, egenskapsändringar, enhetsanslutning och enhetslivscykel:

   • Anpassad sträng: Lägger till en anpassad statisk sträng i varje meddelande. Ange valfri nyckel och ange ett strängvärde.
   • Egenskapen, som lägger till i varje meddelande:
     • Enhetsmetadata, till exempel enhetsnamn, enhetsmallnamn, aktiverat, organisationer, etablerat och simulerat.
     • Den aktuella enhetens rapporterade egenskaps- eller molnegenskapsvärde för varje meddelande. Om det exporterade meddelandet kommer från en enhet som inte har den angivna egenskapen får det exporterade meddelandet inte berikningen.

Konfigurera målet:

1. Lägg till ett nytt mål eller lägg till ett mål som du redan har skapat. Välj länken Skapa en ny och lägg till följande information:

   • Målnamn: visningsnamnet för målet i IoT Central.
   • Måltyp: Välj måltyp. Om du inte redan har ställt in målet kan du se Konfigurera exportmål.
   • Auktorisering: Välj Anslutningssträng.
   • För Azure Event Hubs, Azure Service Bus-kö eller -ämne klistrar du in anslutningssträngen för din resurs och anger händelsehubben, kön eller ämnesnamnet för den fallkänsliga händelsen om det behövs.
   • För Azure Blob Storage klistrar du in anslutningssträngen för din resurs och anger namnet på den case-känsliga containern om det behövs.
   • För Webhook klistrar du in motringningens URL för webhook-slutpunkten. Du kan också konfigurera webhook-auktorisering (OAuth 2.0 och auktoriseringstoken) och lägga till anpassade huvuden.
     • För OAuth 2.0 stöds endast flödet för klientautentiseringsuppgifter. När målet sparas kommunicerar IoT Central OAuth-providern för att hämta en auktoriseringstoken. Denna token kopplas till rubriken för Authorization varje meddelande som skickas till det här målet.
     • För Auktoriseringstoken kan du ange ett tokenvärde som ska kopplas direkt till Authorization rubriken för varje meddelande som skickas till det här målet.
   • Välj Skapa.

2. Välj + Mål och välj ett mål i listrutan. Du kan lägga till upp till fem mål till en enda export.

3. När du är klar med att konfigurera exporten väljer du Spara. Efter några minuter visas dina data i dina mål.

Nu när du har ett mål att exportera dina data till kan du konfigurera dataexport i IoT Central program:

1. Logga in på ditt IoT Central program.

2. I den vänstra rutan väljer du Dataexport.

   Tips

   Om du inte ser Dataexport i det vänstra fönstret har du inte behörighet att konfigurera dataexport i din app. Kontakta en administratör för att konfigurera dataexport.

3. Välj + Ny export.

4. Ange ett visningsnamn för den nya exporten och kontrollera att dataexporten är Aktiverad.

5. Välj vilken typ av data som ska exporteras. I följande tabell visas de typer av dataexport som stöds:

   Datatyp	Beskrivning	Dataformat
   Telemetri	Exportera telemetrimeddelanden från enheter nästan i realtid. Varje exporterat meddelande innehåller det fullständiga innehållet i det ursprungliga enhetsmeddelandet, normaliserat.	Meddelandeformat för telemetri
   Egenskapsändringar	Exportera ändringar av enhets- och molnegenskaper nästan i realtid. För skrivskyddade enhetsegenskaper exporteras ändringar av de rapporterade värdena. För läs- och skrivegenskaper exporteras både rapporterade och önskade värden.	Meddelandeformat för ändring av egenskap
   Enhetsanslutning	Exportera enhetsanslutna och frånkopplade händelser.	Meddelandeformat för enhetsanslutning
   Enhetslivscykel	Exportera registrerade, borttagna, etablerade, aktiverade, inaktiverade, displayNameChanged och deviceTemplateChanged-händelser.	Meddelandeformat för enhetslivscykeländringar
   Livscykel för enhetsmall	Exportera publicerade enhetsmalländringar, inklusive skapade, uppdaterade och borttagna.	Meddelandeformat för ändring av enhetsmallslivscykel

6. Du kan också lägga till filter för att minska mängden data som exporteras. Det finns olika typer av filter för varje dataexporttyp:

   Typ av data	Tillgängliga filter
   Telemetri	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten simuleras Filtrera dataströmmen så att den endast innehåller telemetri som uppfyller filtervillkoren Filtrera dataströmmen så att den endast innehåller telemetri från enheter med egenskaper som matchar filtervillkoren Filtrera dataströmmen så att den endast innehåller telemetri som har meddelandeegenskaper som uppfyller filtervillkoret. Meddelandeegenskaper (även kallade programegenskaper) skickas i en påse med nyckel/värde-par på varje telemetrimeddelande som eventuellt skickas av enheter som använder enhets-SDK:erna. Om du vill skapa ett filter för meddelandeegenskap anger du den nyckel för meddelandeegenskap som du letar efter och anger ett villkor. Endast telemetrimeddelanden med egenskaper som matchar det angivna filtervillkoret exporteras. Läs mer om programegenskaper från IoT Hub dokument
   Egenskapsändringar	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten simuleras Filtrera dataströmmen så att den endast innehåller egenskapsändringar som uppfyller filtervillkoren
   Enhetsanslutning	Filtrera efter enhetsnamn, enhets-ID, enhetsmall, organisationer och om enheten simuleras Filtrera dataströmmen så att den endast innehåller ändringar från enheter med egenskaper som matchar filtervillkoren
   Enhetslivscykel	Filtrera efter enhetsnamn, enhets-ID, enhetsmall och om enheten har etablerats, aktiverats eller simulerats Filtrera dataströmmen så att den endast innehåller ändringar från enheter med egenskaper som matchar filtervillkoren
   Livscykel för enhetsmall	Filtrera efter enhetsmall

7. Du kan också utöka exporterade meddelanden med extra nyckel/värde-parmetadata. Följande berikningar är tillgängliga för exporttyperna telemetri, egenskapsändringar, enhetsanslutning och enhetslivscykel:

   • Anpassad sträng: Lägger till en anpassad statisk sträng i varje meddelande. Ange valfri nyckel och ange ett strängvärde.
   • Egenskapen, som lägger till i varje meddelande:
     • Enhetsmetadata, till exempel enhetsnamn, enhetsmallnamn, aktiverat, organisationer, etablerat och simulerat.
     • Den aktuella enhetens rapporterade egenskaps- eller molnegenskapsvärde för varje meddelande. Om det exporterade meddelandet kommer från en enhet som inte har den angivna egenskapen får det exporterade meddelandet inte berikningen.

Konfigurera målet:

1. Lägg till ett nytt mål eller lägg till ett mål som du redan har skapat. Välj länken Skapa en ny och lägg till följande information:

   • Målnamn: visningsnamnet för målet i IoT Central.
   • Måltyp: Välj måltyp. Om du inte redan har ställt in målet kan du se Konfigurera exportmål.
   • Auktorisering: välj System-tilldelad hanterad identitet.
   • För Azure Event Hubs och Azure Service Bus kö eller ämne anger du värdnamnet för din resurs. Ange sedan den ärendekänsliga händelsehubben, kön eller ämnesnamnet. Ett värdnamn ser ut så här: contoso-waste.servicebus.windows.net .
   • För Azure Blob Storage anger du slutpunkts-URI för ditt lagringskonto och det ärendekänsliga containernamnet. En slutpunkts-URI ser ut så här: https://contosowaste.blob.core.windows.net .
   • För Webhook klistrar du in motringningens URL för webhook-slutpunkten. Du kan också konfigurera webhook-auktorisering (OAuth 2.0 och auktoriseringstoken) och lägga till anpassade huvuden.
     • För OAuth 2.0 stöds endast flödet för klientautentiseringsuppgifter. När målet sparas kommunicerar IoT Central OAuth-providern för att hämta en auktoriseringstoken. Denna token kopplas till rubriken för Authorization varje meddelande som skickas till det här målet.
     • För Auktoriseringstoken kan du ange ett tokenvärde som ska kopplas direkt till Authorization rubriken för varje meddelande som skickas till det här målet.
   • Välj Skapa.

2. Välj + Mål och välj ett mål i listrutan. Du kan lägga till upp till fem mål till en enda export.

3. När du är klar med att konfigurera exporten väljer du Spara. Efter några minuter visas dina data i dina mål.

async function sendTelemetry(deviceClient, index) {
  console.log('Sending telemetry message %d...', index);
  const msg = new Message(
    JSON.stringify(
      deviceTemperatureSensor.updateSensor().getCurrentTemperatureObject()
    )
  );
  msg.properties.add("iothub-creation-time-utc", new Date().toISOString());
  msg.contentType = 'application/json';
  msg.contentEncoding = 'utf-8';
  await deviceClient.sendEvent(msg);
}

private static void sendTemperatureTelemetry() {
  String telemetryName = "temperature";
  String telemetryPayload = String.format("{\"%s\": %f}", telemetryName, temperature);

  Message message = new Message(telemetryPayload);
  message.setContentEncoding(StandardCharsets.UTF_8.name());
  message.setContentTypeFinal("application/json");
  message.setProperty("iothub-creation-time-utc", Instant.now().toString());

  deviceClient.sendEventAsync(message, new MessageIotHubEventCallback(), message);
  log.debug("My Telemetry: Sent - {\"{}\": {}°C} with message Id {}.", telemetryName, temperature, message.getMessageId());
  temperatureReadings.put(new Date(), temperature);
}

private async Task SendTemperatureTelemetryAsync()
{
  const string telemetryName = "temperature";

  string telemetryPayload = $"{{ \"{telemetryName}\": {_temperature} }}";
  using var message = new Message(Encoding.UTF8.GetBytes(telemetryPayload))
  {
      ContentEncoding = "utf-8",
      ContentType = "application/json",
  };
  message.Properties.Add("iothub-creation-time-utc", DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ"));
  await _deviceClient.SendEventAsync(message);
  _logger.LogDebug($"Telemetry: Sent - {{ \"{telemetryName}\": {_temperature}°C }}.");
}

async def send_telemetry_from_thermostat(device_client, telemetry_msg):
    msg = Message(json.dumps(telemetry_msg))
    msg.custom_properties["iothub-creation-time-utc"] = datetime.now(timezone.utc).isoformat()
    msg.content_encoding = "utf-8"
    msg.content_type = "application/json"
    print("Sent message")
    await device_client.send_message(msg)