Export dat IoT do cílových umístění v cloudu pomocí exportu dat

Pokud nemáte existující obor názvů, do Event Hubs exportovat, postupujte následovně:

1. V části Event Hubs vytvořte nový obor názvů Azure Portal. Další informace najdete v Azure Event Hubs docs.

2. Ve svém oboru názvů služby Event Hubs událostí. Přejděte do svého oboru názvů a v horní části vyberte + Centrum událostí a vytvořte instanci centra událostí.

3. Vygenerujte klíč, který se použije při nastavení exportu dat v IoT Central:

   • Vyberte instanci centra událostí, kterou jste vytvořili.
   • Vyberte Nastavení > zásady sdíleného přístupu.
   • Vytvořte nový klíč nebo zvolte existující klíč, který má oprávnění Odeslat.
   • Zkopírujte primární nebo sekundární připojovací řetězec. Tento připojovací řetězec použijete k nastavení nového cíle v IoT Central.
   • Alternativně můžete vygenerovat připojovací řetězec pro celý Event Hubs názvů:
     1. V části Event Hubs přejděte do svého Azure Portal.
     2. V Nastavení vyberte Zásady sdíleného přístupu.
     3. Vytvořte nový klíč nebo zvolte existující klíč, který má oprávnění Odeslat.
     4. Zkopírujte primární nebo sekundární připojovací řetězec.

Pokud nemáte existující obor názvů, do Event Hubs exportovat, postupujte následovně:

1. V části Event Hubs vytvořte nový obor názvů Azure Portal. Další informace najdete v Azure Event Hubs docs.

2. Ve svém oboru názvů služby Event Hubs událostí. Přejděte do svého oboru názvů a v horní části vyberte + Centrum událostí a vytvořte instanci centra událostí.

Konfigurace spravované identity, která vaší aplikaci IoT Central bezpečně exportovat data do centra událostí:

1. V Azure Portalpřejděte na svou aplikaci IoT Central.

   Tip

   Ve výchozím nastavení IoT Central aplikace ve skupině prostředků IOTC ve vašem předplatném.

2. Vyberte Identita. Potom na stránce Přiřazeno systémem změňte stav na On a pak vyberte Save (Uložit).

3. Po několika sekundách se povolí spravovaná identita přiřazená systémem IoT Central vaší aplikace a můžete vybrat Přiřazení rolí Azure:

   

4. Na stránce Přiřazení rolí Azure vyberte + Přidat přiřazení role.

Konfigurace oprávnění:

1. Na stránce Přidat přiřazení role vyberte obor a předplatné, které chcete použít.

   Tip

   Pokud vaše IoT Central aplikace a centrum událostí jsou ve stejné skupině prostředků, můžete jako obor zvolit Skupina prostředků a pak vybrat skupinu prostředků.

2. Jako Azure Event Hubs vyberte Odesílatel dat.

3. Vyberte Uložit. Spravovaná identita vaší IoT Central aplikace je teď nakonfigurovaná.

Další zabezpečení centra událostí a povolení přístupu pouze z důvěryhodných služeb pomocí spravovaných identit najdete v tématu:

• Povolení přístupu k Azure Event Hubs oborům názvů pomocí privátních koncových bodů
• Důvěryhodné služby Microsoft
• Povolení přístupu k Azure Event Hubs z konkrétních virtuálních sítí

Pokud nemáte existující obor názvů Service Bus exportu, postupujte následovně:

1. Vytvořte nový obor názvů Service Bus v Azure Portal. Další informace najdete na webu Azure Service Bus docs.

2. Pokud chcete vytvořit frontu nebo téma pro export, přejděte do svého oboru názvů Service Bus a vyberte + Fronta nebo + Téma.

3. Vygenerujte klíč, který se použije při nastavení exportu dat v IoT Central:

   • Vyberte frontu nebo téma, které jste vytvořili.
   • Vyberte Nastavení/sdílený přístup.
   • Vytvořte nový klíč nebo zvolte existující klíč, který má oprávnění Odeslat.
   • Zkopírujte primární nebo sekundární připojovací řetězec. Tento připojovací řetězec použijete k nastavení nového cíle v IoT Central.
   • Alternativně můžete vygenerovat připojovací řetězec pro celý obor Service Bus názvů:
     1. V části Service Bus přejděte ke svému Azure Portal.
     2. V Nastavení vyberte Zásady sdíleného přístupu.
     3. Vytvořte nový klíč nebo zvolte existující klíč, který má oprávnění Odeslat.
     4. Zkopírujte primární nebo sekundární připojovací řetězec.

Pokud nemáte existující obor názvů Service Bus exportu, postupujte následovně:

1. Vytvořte nový obor názvů Service Bus v Azure Portal. Další informace najdete na webu Azure Service Bus docs.

2. Pokud chcete vytvořit frontu nebo téma pro export, přejděte do svého oboru názvů Service Bus a vyberte + Fronta nebo + Téma.

Konfigurace spravované identity, která vaší aplikaci IoT Central bezpečně exportovat data do centra událostí:

1. V Azure Portalpřejděte na svou aplikaci IoT Central.

   Tip

   Ve výchozím nastavení IoT Central aplikace ve skupině prostředků IOTC ve vašem předplatném.

2. Vyberte Identita. Potom na stránce Přiřazeno systémem změňte stav na On a pak vyberte Save (Uložit).

3. Po několika sekundách se povolí spravovaná identita přiřazená systémem IoT Central vaší aplikace a můžete vybrat Přiřazení rolí Azure:

   

4. Na stránce Přiřazení rolí Azure vyberte + Přidat přiřazení role.

Konfigurace oprávnění:

1. Na stránce Přidat přiřazení role vyberte rozsah a předplatné, které chcete použít.

   Tip

   Pokud se vaše aplikace IoT Central a fronta nebo téma nacházejí ve stejné skupině prostředků, můžete zvolit skupinu prostředků jako obor a pak vybrat skupinu prostředků.

2. jako roli vyberte Azure Service Bus Data Sender .

3. Vyberte Uložit. Spravovaná identita pro vaši aplikaci IoT Central je teď nakonfigurovaná.

K dalšímu zabezpečení vaší fronty nebo tématu a povolení přístupu z důvěryhodných služeb se spravovanými identitami se podívejte na:

• povolení přístupu k oborům názvů Azure Service Bus pomocí privátních koncových bodů
• důvěryhodné služby Microsoft
• povolení přístupu k oboru názvů Azure Service Bus z konkrétních virtuálních sítí

Pokud nemáte existující účet úložiště Azure pro export do, postupujte takto:

1. Vytvořte nový účet úložiště v Azure Portal. můžete si přečíst další informace o vytváření nových účtů úložiště Azure Blob nebo Azure Data Lake Storagech účtů úložiště v2. Export dat může zapisovat jenom data do účtů úložiště, které podporují objekty blob bloku. Následující seznam uvádí známé kompatibilní typy účtů úložiště:

   Úroveň výkonu	Typ účtu
   Standard	Pro obecné účely v2
   Standard	Pro obecné účely v1
   Standard	Blob Storage
   Premium	Úložiště objektů blob bloku

2. Pokud chcete vytvořit kontejner v účtu úložiště, klikněte na účet úložiště. V části BLOB Service vyberte Procházet objekty blob. V horní části vyberte + kontejner a vytvořte nový kontejner.

3. kliknutím na Nastavení > přístupové klíče vygenerujte připojovací řetězec pro váš účet úložiště. Zkopírujte jeden ze dvou připojovacích řetězců.

Pokud nemáte existující účet úložiště Azure pro export do, postupujte takto:

1. Vytvořte nový účet úložiště v Azure Portal. můžete si přečíst další informace o vytváření nových účtů úložiště Azure Blob nebo Azure Data Lake Storagech účtů úložiště v2. Export dat může zapisovat jenom data do účtů úložiště, které podporují objekty blob bloku. Následující seznam uvádí známé kompatibilní typy účtů úložiště:

   Úroveň výkonu	Typ účtu
   Standard	Pro obecné účely v2
   Standard	Pro obecné účely v1
   Standard	Blob Storage
   Premium	Úložiště objektů blob bloku

2. Pokud chcete vytvořit kontejner v účtu úložiště, klikněte na účet úložiště. V části BLOB Service vyberte Procházet objekty blob. V horní části vyberte + kontejner a vytvořte nový kontejner.

Konfigurace spravované identity, která vaší aplikaci IoT Central bezpečně exportovat data do centra událostí:

1. V Azure Portalpřejděte na svou aplikaci IoT Central.

   Tip

   Ve výchozím nastavení IoT Central aplikace ve skupině prostředků IOTC ve vašem předplatném.

2. Vyberte Identita. Potom na stránce Přiřazeno systémem změňte stav na On a pak vyberte Save (Uložit).

3. Po několika sekundách se povolí spravovaná identita přiřazená systémem IoT Central vaší aplikace a můžete vybrat Přiřazení rolí Azure:

   

4. Na stránce Přiřazení rolí Azure vyberte + Přidat přiřazení role.

Konfigurace oprávnění:

1. na stránce přidat přiřazení role vyberte předplatné, které chcete použít, a Storage jako obor. Pak jako prostředek vyberte svůj účet úložiště.

2. jako roli vyberte Storage přispěvatel dat objektů Blob .

3. Vyberte Uložit. Spravovaná identita pro vaši aplikaci IoT Central je teď nakonfigurovaná.

   Tip

   Toto přiřazení role není v seznamu na stránce přiřazení rolí Azure viditelné.

K dalšímu zabezpečení kontejneru objektů BLOB a povolení přístupu z důvěryhodných služeb se spravovanými identitami se podívejte na:

• Použití privátních koncových bodů pro Azure Storage
• Autorizace přístupu k datům objektu BLOB se spravovanými identitami pro prostředky Azure
• Konfigurace bran firewall Azure Storage a virtuálních sítí

Teď, když máte cíl pro export dat, nastavte export dat ve vaší IoT Central aplikace:

1. Přihlaste se k IoT Central aplikaci.

2. V levém podokně vyberte Export dat.

   Tip

   Pokud v levém podokně nevidíte Export dat, nemáte oprávnění ke konfiguraci exportu dat ve vaší aplikaci. Pokud chcete nastavit export dat, promluvte si se správcem.

3. Vyberte + Nový export.

4. Zadejte zobrazovaný název nového exportu a ujistěte se, že je pro export dat nastavená možnost Povoleno.

5. Zvolte typ dat, která chcete exportovat. Následující tabulka uvádí podporované typy exportu dat:

   Datový typ	Popis	Formát dat
   Telemetrie	Exportujte zprávy telemetrie ze zařízení v reálném čase. Každá exportovaná zpráva obsahuje úplný obsah původní zprávy zařízení normalizované.	Formát telemetrických zpráv
   Změny vlastností	Exportujte změny vlastností zařízení a cloudu v reálném čase. U vlastností zařízení jen pro čtení se exportuje změny ohlášených hodnot. U vlastností pro čtení i zápis se exportuje hlášené i požadované hodnoty.	Formát zprávy o změně vlastnosti
   Připojení zařízení	Exportujte události připojené a odpojené zařízení.	Formát zprávy o připojení zařízení
   Životní cyklus zařízení	Export událostí registrovaných, odstraněných, zřízených, povolených, zakázaných, displayNameChanged a deviceTemplateChanged	Formát zprávy změny životního cyklu zařízení
   Životní cyklus šablony zařízení	Exportujte publikované změny šablony zařízení, včetně vytvořených, aktualizovaných a odstraněných.	Životní cyklus šablony zařízení změní formát zprávy

6. Volitelně můžete přidat filtry, abyste snížili objem exportovaných dat. Pro každý typ exportu dat jsou k dispozici různé typy filtrů:

   Typ dat	Dostupné filtry
   Telemetrie	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení simulované Filtrování datového proudu tak, aby obsahoval jenom telemetrii, která splňuje podmínky filtru Filtrování datového proudu tak, aby obsahoval jenom telemetrii ze zařízení s vlastnostmi, které odpovídají podmínkám filtru Filtrujte datový proud tak, aby obsahoval pouze telemetrii, která má vlastnosti zprávy splňující podmínku filtru. Vlastnosti zpráv (označované také jako vlastnosti aplikace) se do každé telemetrické zprávy odesílané volitelně odesílaly zařízeními, která používají tyto páry SDK zařízení. Pokud chcete vytvořit filtr vlastností zprávy, zadejte klíč vlastnosti zprávy, který hledáte, a zadejte podmínku. Exportují se pouze zprávy telemetrie s vlastnostmi, které odpovídají zadané podmnozi filtru. Další informace o vlastnostech aplikace najdete v IoT Hub docs.
   Změny vlastností	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení simulované Filtrujte datový proud tak, aby obsahoval pouze změny vlastností, které splňují podmínky filtru.
   Připojení zařízení	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení, organizací a toho, jestli je zařízení simulované Filtrujte datový proud tak, aby obsahoval pouze změny ze zařízení s vlastnostmi, které odpovídají podmínkám filtru.
   Životní cyklus zařízení	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení zřízené, povolené nebo simulované Filtrujte datový proud tak, aby obsahoval pouze změny ze zařízení s vlastnostmi, které odpovídají podmínkám filtru.
   Životní cyklus šablony zařízení	Filtrovat podle šablony zařízení

7. Volitelně můžete obohatit exportované zprávy o další metadata páru klíč-hodnota. Pro typy telemetrie, změn vlastností, připojení zařízení a exportu dat životního cyklu zařízení jsou k dispozici následující rozšíření:

   • Vlastní řetězec: Ke každé zprávě přidá vlastní statický řetězec. Zadejte libovolný klíč a zadejte libovolnou řetězcovou hodnotu.
   • Vlastnost, která ke každé zprávě přidá:
     • Metadata zařízení, jako je název zařízení, název šablony zařízení, povoleno, organizace, zřízené a simulované.
     • Aktuální hlášená vlastnost zařízení nebo hodnota cloudové vlastnosti každé zprávě. Pokud exportovaná zpráva pochází ze zařízení, které nemá zadanou vlastnost, exportovaná zpráva rozšíření nezískadí.

Nakonfigurujte cíl:

1. Přidejte nový cíl nebo přidejte cíl, který jste už vytvořili. Vyberte odkaz Vytvořit nový a přidejte následující informace:

   • Název cíle: zobrazovaný název cíle v IoT Central.
   • Typ cíle: Zvolte typ cíle. Pokud jste ještě nenastavíte cíl, podívejte se na stránku Nastavení cíle exportu.
   • Autorizace: Vyberte Připojovací řetězec.
   • Například Azure Event Hubs, frontu nebo téma Azure Service Bus, vložte připojovací řetězec pro váš prostředek a v případě potřeby zadejte centrum událostí, frontu nebo název tématu, ve které se rozlišují malá a velká písmena.
   • V části Azure Blob Storage vložte připojovací řetězec pro váš prostředek a v případě potřeby zadejte název kontejneru s rozlišování malých a malých písmen.
   • Jako Webhook vložte adresu URL zpětného volání koncového bodu webhooku. Volitelně můžete nakonfigurovat autorizaci webhooku (OAuth 2.0 a autorizační token) a přidat vlastní hlavičky.
     • Pro OAuth 2.0 se podporuje pouze tok přihlašovacích údajů klienta. Po uložení cíle bude IoT Central s vaším poskytovatelem OAuth a načte autorizační token. Tento token se připojí k Authorization hlavičce každé zprávy odeslané do tohoto cíle.
     • Jako Autorizační token můžete zadat hodnotu tokenu, která bude přímo připojená k hlavičce pro každou Authorization zprávu odeslanou do tohoto cíle.
   • Vyberte Vytvořit.

2. Vyberte + Cíl a v rozevíracím seznamu zvolte cíl. Do jednoho exportu můžete přidat až pět cílů.

3. Až nastavení exportu dokončíte, vyberte Uložit. Po několika minutách se vaše data zobrazí ve vašich cílech.

Teď, když máte cíl pro export dat, nastavte export dat ve vaší IoT Central aplikace:

1. Přihlaste se k IoT Central aplikaci.

2. V levém podokně vyberte Export dat.

   Tip

   Pokud v levém podokně nevidíte Export dat, nemáte oprávnění ke konfiguraci exportu dat ve vaší aplikaci. Pokud chcete nastavit export dat, promluvte si se správcem.

3. Vyberte + Nový export.

4. Zadejte zobrazovaný název nového exportu a ujistěte se, že je pro export dat nastavená možnost Povoleno.

5. Zvolte typ dat, která chcete exportovat. Následující tabulka uvádí podporované typy exportu dat:

   Datový typ	Popis	Formát dat
   Telemetrie	Exportujte zprávy telemetrie ze zařízení v reálném čase. Každá exportovaná zpráva obsahuje úplný obsah původní zprávy zařízení normalizované.	Formát telemetrických zpráv
   Změny vlastností	Exportujte změny vlastností zařízení a cloudu v reálném čase. U vlastností zařízení jen pro čtení se exportuje změny ohlášených hodnot. U vlastností pro čtení i zápis se exportuje hlášené i požadované hodnoty.	Formát zprávy o změně vlastnosti
   Připojení zařízení	Exportujte události připojené a odpojené zařízení.	Formát zprávy o připojení zařízení
   Životní cyklus zařízení	Export událostí registrovaných, odstraněných, zřízených, povolených, zakázaných, displayNameChanged a deviceTemplateChanged	Formát zprávy změny životního cyklu zařízení
   Životní cyklus šablony zařízení	Exportujte publikované změny šablony zařízení, včetně vytvořených, aktualizovaných a odstraněných.	Životní cyklus šablony zařízení změní formát zprávy

6. Volitelně můžete přidat filtry, abyste snížili objem exportovaných dat. Pro každý typ exportu dat jsou k dispozici různé typy filtrů:

   Typ dat	Dostupné filtry
   Telemetrie	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení simulované Filtrování datového proudu tak, aby obsahoval jenom telemetrii, která splňuje podmínky filtru Filtrování datového proudu tak, aby obsahoval jenom telemetrii ze zařízení s vlastnostmi, které odpovídají podmínkám filtru Filtrujte datový proud tak, aby obsahoval pouze telemetrii, která má vlastnosti zprávy splňující podmínku filtru. Vlastnosti zpráv (označované také jako vlastnosti aplikace) se do každé telemetrické zprávy odesílané volitelně odesílaly zařízeními, která používají tyto páry SDK zařízení. Pokud chcete vytvořit filtr vlastností zprávy, zadejte klíč vlastnosti zprávy, který hledáte, a zadejte podmínku. Exportují se pouze zprávy telemetrie s vlastnostmi, které odpovídají zadané podmnozi filtru. Další informace o vlastnostech aplikace najdete v IoT Hub docs.
   Změny vlastností	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení simulované Filtrujte datový proud tak, aby obsahoval pouze změny vlastností, které splňují podmínky filtru.
   Připojení zařízení	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení, organizací a toho, jestli je zařízení simulované Filtrujte datový proud tak, aby obsahoval pouze změny ze zařízení s vlastnostmi, které odpovídají podmínkám filtru.
   Životní cyklus zařízení	Filtrování podle názvu zařízení, ID zařízení, šablony zařízení a toho, jestli je zařízení zřízené, povolené nebo simulované Filtrujte datový proud tak, aby obsahoval pouze změny ze zařízení s vlastnostmi, které odpovídají podmínkám filtru.
   Životní cyklus šablony zařízení	Filtrovat podle šablony zařízení

7. Volitelně můžete obohatit exportované zprávy o další metadata páru klíč-hodnota. Pro typy telemetrie, změn vlastností, připojení zařízení a exportu dat životního cyklu zařízení jsou k dispozici následující rozšíření:

   • Vlastní řetězec: Ke každé zprávě přidá vlastní statický řetězec. Zadejte libovolný klíč a zadejte libovolnou řetězcovou hodnotu.
   • Vlastnost, která ke každé zprávě přidá:
     • Metadata zařízení, jako je název zařízení, název šablony zařízení, povoleno, organizace, zřízené a simulované.
     • Aktuální hlášená vlastnost zařízení nebo hodnota cloudové vlastnosti každé zprávě. Pokud exportovaná zpráva pochází ze zařízení, které nemá zadanou vlastnost, exportovaná zpráva rozšíření nezískadí.

Nakonfigurujte cíl:

1. Přidejte nový cíl nebo cíl, který jste už vytvořili. Vyberte odkaz Vytvořit nový a přidejte následující informace:

   • Název cíle: zobrazovaný název cíle v IoT Central.
   • Typ cíle: Zvolte typ cíle. Pokud jste ještě nenastavíte cíl, podívejte se na stránku Nastavení cíle exportu.
   • Autorizace: Vyberte spravovanou identitu přiřazenou systémem.
   • Jako Azure Event Hubs a azure Service Bus frontu nebo téma zadejte název hostitele pro váš prostředek. Pak zadejte centrum událostí, frontu nebo název tématu, ve které se rozlišují malá a velká písmena. Název hostitele vypadá jako: contoso-waste.servicebus.windows.net .
   • V části Azure Blob Storage zadejte identifikátor URI koncového bodu pro váš účet úložiště a název kontejneru s rozlišování malých a malých písmen. Identifikátor URI koncového bodu vypadá jako: https://contosowaste.blob.core.windows.net .
   • Jako Webhook vložte adresu URL zpětného volání koncového bodu webhooku. Volitelně můžete nakonfigurovat autorizaci webhooku (OAuth 2.0 a autorizační token) a přidat vlastní hlavičky.
     • Pro OAuth 2.0 se podporuje pouze tok přihlašovacích údajů klienta. Po uložení cíle bude IoT Central s vaším poskytovatelem OAuth a načte autorizační token. Tento token se připojí k Authorization hlavičce každé zprávy odeslané do tohoto cíle.
     • Jako Autorizační token můžete zadat hodnotu tokenu, která bude přímo připojená k hlavičce pro každou Authorization zprávu odeslanou do tohoto cíle.
   • Vyberte Vytvořit.

2. Vyberte + Cíl a v rozevíracím seznamu zvolte cíl. Do jednoho exportu můžete přidat až pět cílů.

3. Až nastavení exportu dokončíte, vyberte Uložit. Po několika minutách se vaše data zobrazí ve vašich cílech.

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)