IoT-adatexportálás a Felhőbeli célhelyekre az adatexportálás használatávalExport IoT data to cloud destinations using data export

Megjegyzés

Ez a cikk a IoT Central adatexportálási funkcióit ismerteti.This article describes the data export features in IoT Central. Az örökölt adatexportálási funkciókkal kapcsolatos információkért lásd: IoT-adatok exportálása a Felhőbeli célhelyekre adatexportálás (örökölt) használatával.For information about the legacy data export features, see Export IoT data to cloud destinations using data export (legacy).

Ez a cikk azt ismerteti, hogyan használható az új adatexportálási funkció az Azure IoT Centralban.This article describes how to use the new data export feature in Azure IoT Central. Ezzel a szolgáltatással folyamatosan exportálhatja a szűrt és a dúsított IoT-adatait a IoT Central alkalmazásból.Use this feature to continuously export filtered and enriched IoT data from your IoT Central application. Az adatexportálás leküldi a közel valós idejű változásokat a felhőalapú megoldás más részeire a meleg elérésű elemzések, az elemzések és a tárolás érdekében.Data export pushes changes in near real time to other parts of your cloud solution for warm-path insights, analytics, and storage.

Megteheti például a következőt:For example, you can:

  • A telemetria, a tulajdonságok módosításait, az eszközök életciklusát és az eszközök sablonjának életciklus-alapú, közel valós időben történő exportálását.Continuously export telemetry, property changes, device lifecycle, and device template lifecycle data in JSON format in near-real time.
  • Az adatstreamek szűrésével exportálhatja az egyéni feltételekkel egyező adatforgalmat.Filter the data streams to export data that matches custom conditions.
  • Az adatstreamek az eszköz egyéni értékeivel és tulajdonságértékek gazdagítása.Enrich the data streams with custom values and property values from the device.
  • Az Azure Event Hubs, a Azure Service Bus, az Azure Blob Storage és a webhook-végpontok számára küldje el az összes olyan célhelyet.Send the data to destinations such as Azure Event Hubs, Azure Service Bus, Azure Blob Storage, and webhook endpoints.

Tipp

Amikor bekapcsolja az adatexportálást, a rendszer csak az adott pillanattól kezdve kapja meg az adatait.When you turn on data export, you get only the data from that moment onward. Jelenleg nem lehet lekérni az adatexportálást olyan időpontra, amikor az adatexportálás ki lett kapcsolva.Currently, data can't be retrieved for a time when data export was off. Több korábbi adat megtartásához kapcsolja be a korai adatexportálást.To retain more historical data, turn on data export early.

ElőfeltételekPrerequisites

Az adatexportálási funkciók használatához v3 alkalmazásszükséges, és rendelkeznie kell az adatexportálási engedéllyel.To use data export features, you must have a V3 application, and you must have the Data export permission.

Ha v2-alkalmazással rendelkezik, tekintse meg a v2 IoT Central alkalmazás áttelepítését v3 verzióracímű témakört.If you have a V2 application, see Migrate your V2 IoT Central application to V3.

Exportálás célhelyének beállításaSet up export destination

Az exportálási célhelynek az adatexportálás konfigurálása előtt léteznie kell.Your export destination must exist before you configure your data export. Jelenleg a következő típusú célhelyek érhetők el:The following destination types are currently available:

  • Azure Event HubsAzure Event Hubs
  • Azure Service Bus-üzenetsorAzure Service Bus queue
  • Azure Service Bus-témakörAzure Service Bus topic
  • Azure Blob StorageAzure Blob Storage
  • WebhookWebhook

Event Hubs célhely létrehozásaCreate an Event Hubs destination

Ha nem rendelkezik meglévő Event Hubs-névtérrel az exportáláshoz, kövesse az alábbi lépéseket:If you don't have an existing Event Hubs namespace to export to, follow these steps:

  1. Hozzon létre egy új Event Hubs névteret a Azure Portalban.Create a new Event Hubs namespace in the Azure portal. További információt az Azure Event Hubs dokumentációjábanolvashat.You can learn more in Azure Event Hubs docs.

  2. Hozzon létre egy Event hubot a Event Hubs névtérben.Create an event hub in your Event Hubs namespace. Nyissa meg a névteret, és a felül található + Event hub elemet választva hozzon létre egy Event hub-példányt.Go to your namespace, and select + Event Hub at the top to create an event hub instance.

  3. Hozzon létre egy kulcsot, amelyet akkor kell használni, ha az adatexportálást IoT Centralban állítja be:Generate a key to use when you to set up your data export in IoT Central:

    • Válassza ki a létrehozott Event hub-példányt.Select the event hub instance you created.
    • Válassza a beállítások > a közös hozzáférési szabályzatok lehetőséget.Select Settings > Shared access policies.
    • Hozzon létre egy új kulcsot, vagy válasszon olyan meglévő kulcsot, amely rendelkezik küldési engedéllyel.Create a new key or choose an existing key that has Send permissions.
    • Másolja az elsődleges vagy a másodlagos kapcsolatok sztringjét.Copy either the primary or secondary connection string. Ezt a kapcsolódási karakterláncot használva új célhelyet állíthat be IoT Centralban.You use this connection string to set up a new destination in IoT Central.
    • Azt is megteheti, hogy a teljes Event Hubs névtérhez létrehoz egy kapcsolatok karakterláncot:Alternatively, you can generate a connection string for the entire Event Hubs namespace:
      1. Nyissa meg a Event Hubs névteret a Azure Portalban.Go to your Event Hubs namespace in the Azure portal.
      2. A Beállítások területen válassza a megosztott elérési szabályzatok elemet.Under Settings, select Shared Access Policies
      3. Hozzon létre egy új kulcsot, vagy válasszon olyan meglévő kulcsot, amely rendelkezik küldési engedéllyel.Create a new key or choose an existing key that has Send permissions.
      4. Az elsődleges vagy a másodlagos kapcsolatok karakterláncának másolásaCopy either the primary or secondary connection string

Service Bus üzenetsor vagy témakör célhelyének létrehozásaCreate a Service Bus queue or topic destination

Ha nem rendelkezik meglévő Service Bus-névtérrel az exportáláshoz, kövesse az alábbi lépéseket:If you don't have an existing Service Bus namespace to export to, follow these steps:

  1. Hozzon létre egy új Service Bus névteret a Azure Portalban.Create a new Service Bus namespace in the Azure portal. Azure Service Bus dokumentációbanbővebben is olvashat.You can learn more in Azure Service Bus docs.

  2. Az exportáláshoz használandó üzenetsor vagy témakör létrehozásához nyissa meg a Service Bus névteret, és válassza a + üzenetsor vagy a + témakör lehetőséget.To create a queue or topic to export to, go to your Service Bus namespace, and select + Queue or + Topic.

  3. Hozzon létre egy kulcsot, amelyet akkor kell használni, ha az adatexportálást IoT Centralban állítja be:Generate a key to use when you to set up your data export in IoT Central:

    • Válassza ki a létrehozott várólistát vagy témakört.Select the queue or topic you created.
    • Válassza a Beállítások/közös hozzáférési szabályzatok lehetőséget.Select Settings/Shared access policies.
    • Hozzon létre egy új kulcsot, vagy válasszon olyan meglévő kulcsot, amely rendelkezik küldési engedéllyel.Create a new key or choose an existing key that has Send permissions.
    • Másolja az elsődleges vagy a másodlagos kapcsolatok sztringjét.Copy either the primary or secondary connection string. Ezt a kapcsolódási karakterláncot használva új célhelyet állíthat be IoT Centralban.You use this connection string to set up a new destination in IoT Central.
    • Azt is megteheti, hogy a teljes Service Bus névtérhez létrehoz egy kapcsolatok karakterláncot:Alternatively, you can generate a connection string for the entire Service Bus namespace:
      1. Nyissa meg a Service Bus névteret a Azure Portalban.Go to your Service Bus namespace in the Azure portal.
      2. A Beállítások területen válassza a megosztott elérési szabályzatok elemet.Under Settings, select Shared Access Policies
      3. Hozzon létre egy új kulcsot, vagy válasszon olyan meglévő kulcsot, amely rendelkezik küldési engedéllyel.Create a new key or choose an existing key that has Send permissions.
      4. Az elsődleges vagy a másodlagos kapcsolatok karakterláncának másolásaCopy either the primary or secondary connection string

Azure Blob Storage célhely létrehozásaCreate an Azure Blob Storage destination

Ha nem rendelkezik meglévő Azure Storage-fiókkal az exportáláshoz, kövesse az alábbi lépéseket:If you don't have an existing Azure storage account to export to, follow these steps:

  1. Hozzon létre egy új Storage-fiókot a Azure Portal.Create a new storage account in the Azure portal. További információ: új Azure Blob Storage-fiókok vagy Azure Data Lake Storage v2 Storage-fiókoklétrehozása.You can learn more about creating new Azure Blob storage accounts or Azure Data Lake Storage v2 storage accounts. Az adatexportálás csak a blokk blobokat támogató Storage-fiókokba tud írni.Data export can only write data to storage accounts that support block blobs. A következő lista az ismert kompatibilis Storage-fiókok típusait mutatja be:The following list shows the known compatible storage account types:

    TeljesítményszintPerformance Tier Fiók típusaAccount Type
    StandardStandard általános célú v2General Purpose V2
    StandardStandard általános célú v1General Purpose V1
    StandardStandard Blob StorageBlob storage
    PrémiumPremium BLOB Storage letiltásaBlock Blob storage
  2. A Storage-fiókban lévő tároló létrehozásához nyissa meg a Storage-fiókját.To create a container in your storage account, go to your storage account. A blob szolgáltatás alatt válassza a Tallózás Blobok lehetőséget.Under Blob Service, select Browse Blobs. Egy új tároló létrehozásához kattintson a felül található + tároló elemre.Select + Container at the top to create a new container.

  3. A Storage-fiókhoz tartozó kapcsolati karakterlánc létrehozásához nyissa meg a beállítások > hozzáférési kulcsok lehetőséget.Generate a connection string for your storage account by going to Settings > Access keys. Másolja az egyiket a két összekapcsolási karakterláncból.Copy one of the two connection strings.

Webhook-végpont létrehozásaCreate a webhook endpoint

Az adatexportálás nyilvánosan elérhető HTTP webhook-végpontba is elvégezhető.You can export data to a publicly available HTTP webhook endpoint. A RequestBinhasználatával létrehozhat egy teszt webhook-végpontot.You can create a test webhook endpoint using RequestBin. RequestBin-szabályozás a kérelem korlátjának elérésekor:RequestBin throttles request when the request limit is reached:

  1. Nyissa meg a RequestBin.Open RequestBin.
  2. Hozzon létre egy új RequestBin, és másolja a bin URL-címét.Create a new RequestBin and copy the Bin URL. Ezt az URL-címet használja az adatexportálás tesztelésekor.You use this URL when you test your data export.

Az adatexportálás beállításaSet up data export

Most, hogy van egy célhelye az adatai exportálásához, állítsa be az adatexportálást a IoT Central alkalmazásban:Now that you have a destination to export your data to, set up data export in your IoT Central application:

  1. Jelentkezzen be IoT Central alkalmazásba.Sign in to your IoT Central application.

  2. A bal oldali panelen válassza az adatexportálás elemet.In the left pane, select Data export.

    Tipp

    Ha nem látja az adatexportálást a bal oldali ablaktáblán, akkor nincs engedélye az adatexportálás konfigurálására az alkalmazásban.If you don't see Data export in the left pane, then you don't have permissions to configure data export in your app. Az adatexportálás beállításához forduljon a rendszergazdához.Talk to an administrator to set up data export.

  3. Válassza az + új Exportálás lehetőséget.Select + New export.

  4. Adja meg az új Exportálás megjelenítendő nevét, és győződjön meg arról, hogy az adatexportálás engedélyezve van.Enter a display name for your new export, and make sure the data export is Enabled.

  5. Válassza ki az exportálandó adattípust.Choose the type of data to export. A következő táblázat a támogatott adatexportálási típusokat sorolja fel:The following table lists the supported data export types:

    AdattípusData type LeírásDescription AdatformátumData format
    TelemetriaTelemetry Telemetria-üzenetek exportálása az eszközökről közel valós időben.Export telemetry messages from devices in near-real time. Minden exportált üzenet tartalmazza az eredeti üzenet teljes tartalmát, normalizálva.Each exported message contains the full contents of the original device message, normalized. Telemetria-üzenet formátumaTelemetry message format
    Tulajdonságok módosításaProperty changes A módosításokat az eszköz és a felhő tulajdonságai között közel valós időben exportálhatja.Export changes to device and cloud properties in near-real time. A csak olvasható eszköz tulajdonságainál a jelentett értékek módosításai lesznek exportálva.For read-only device properties, changes to the reported values are exported. Az írási és olvasási tulajdonságok esetében a jelentett és a kívánt értékeket is exportálja a rendszer.For read-write properties, both reported and desired values are exported. Tulajdonság-módosítási üzenet formátumaProperty change message format
    Eszközök életciklusaDevice lifecycle Az eszköz regisztrált és törölt eseményeinek exportálása.Export device registered and deleted events. Eszköz életciklusának módosítása üzenet formátumaDevice lifecycle changes message format
    Az eszköz sablonjának életciklusaDevice template lifecycle A közzétett sablon módosításainak exportálása, beleértve a létrehozott, a frissített és a törölt eszközöket.Export published device template changes including created, updated, and deleted. Az eszköz sablonjának életciklusának módosítása üzenet formátumaDevice template lifecycle changes message format
  6. Szükség esetén szűrők hozzáadásával csökkentheti az exportált adatmennyiséget.Optionally, add filters to reduce the amount of data exported. Az egyes adatexportálási típusokhoz különböző típusú szűrők érhetők el: There are different types of filter available for each data export type:

    Adatok típusaType of data Elérhető szűrőkAvailable filters
    TelemetriaTelemetry
    • Szűrés eszköznév, eszköz azonosítója és eszköz sablon alapjánFilter by device name, device ID, and device template
    • Stream szűrése, hogy csak olyan telemetria tartalmazzon, amelyek megfelelnek a szűrési feltételeknekFilter stream to only contain telemetry that meets the filter conditions
    • Az adatfolyam szűrése, hogy csak a szűrési feltételeknek megfelelő tulajdonságokkal rendelkező eszközökről származó telemetria tartalmazzon.Filter stream to only contain telemetry from devices with properties matching the filter conditions
    • Az adatfolyam szűrése úgy történik, hogy csak olyan telemetria tartalmazzon, amelyeknek az üzenet tulajdonságai megfelelnek a szűrő feltételének.Filter stream to only contain telemetry that have message properties meeting the filter condition. Az üzenet tulajdonságai (más néven az alkalmazás tulajdonságai) a kulcs-érték párok egy zacskójában lesznek elküldve az eszköz SDK-kat használó eszközök által telemetria üzenetekben.Message properties (also known as application properties) are sent in a bag of key-value pairs on each telemetry message optionally sent by devices that use the device SDKs. Az üzenet tulajdonságai szűrő létrehozásához adja meg a keresett üzenet tulajdonság kulcsát, és adjon meg egy feltételt.To create a message property filter, enter the message property key you're looking for, and specify a condition. Csak a megadott szűrési feltételnek megfelelő tulajdonságokkal rendelkező telemetria exportálja a rendszer.Only telemetry messages with properties that match the specified filter condition are exported. További információ az alkalmazások tulajdonságairól IoT Hub docs-rólLearn more about application properties from IoT Hub docs
    Tulajdonságok módosításaProperty changes
    • Szűrés eszköznév, eszköz azonosítója és eszköz sablon alapjánFilter by device name, device ID, and device template
    • Az adatfolyam szűrése, hogy csak a szűrési feltételeknek megfelelő tulajdonság-módosításokat tartalmazzonFilter stream to only contain property changes that meet the filter conditions
    Eszközök életciklusaDevice lifecycle
    • Szűrés eszköznév, eszköz azonosítója és eszköz sablon alapjánFilter by device name, device ID, and device template
    • Az adatfolyam szűrése, hogy csak a szűrési feltételeknek megfelelő tulajdonságokkal rendelkező eszközök módosításait tartalmazza.Filter stream to only contain changes from devices with properties matching the filter conditions
    Az eszköz sablonjának életciklusaDevice template lifecycle
    • Szűrés eszköz sablon alapjánFilter by device template
  7. Igény szerint az exportált üzeneteket további kulcs-érték párokkal gazdagíthatja.Optionally, enrich exported messages with additional key-value pair metadata. A következő dúsítások érhetők el a telemetria és a tulajdonsághoz az adatexportálási típusok módosításához: The following enrichments are available for the telemetry and property changes data export types:

    • Egyéni karakterlánc: egyéni statikus karakterláncot hoz létre minden üzenethez.Custom string: Adds a custom static string to each message. Írjon be egy tetszőleges kulcsot, és adjon meg egy karakterlánc-értéket.Enter any key, and enter any string value.
    • Tulajdonság: hozzáadja az aktuális eszköz jelentett tulajdonságát vagy a Felhőbeli tulajdonság értékét az egyes üzenetekhez.Property: Adds the current device reported property or cloud property value to each message. Adjon meg egy kulcsot, és válasszon ki egy eszközt vagy egy Felhőbeli tulajdonságot.Enter any key, and choose a device or cloud property. Ha az exportált üzenet olyan eszközről származik, amely nem rendelkezik a megadott tulajdonsággal, az exportált üzenet nem kapja meg a dúsítást.If the exported message is from a device that doesn't have the specified property, the exported message doesn't get the enrichment.
  8. Adjon hozzá egy új célhelyet, vagy adjon hozzá egy már létrehozott célhelyet.Add a new destination or add a destination that you've already created. Válassza az új létrehozása hivatkozást, és adja hozzá a következő információkat:Select the Create a new one link and add the following information:

    • Cél neve: a célhely megjelenítendő neve IoT Centralban.Destination name: the display name of the destination in IoT Central.
    • Cél típusa: válassza ki a célhely típusát.Destination type: choose the type of destination. Ha még nem állította be a célhelyet, olvassa el az Exportálás célhelyének beállításacímű témakört.If you haven't already set up your destination, see Set up export destination.
    • Az Azure Event Hubs, Azure Service Bus üzenetsor vagy témakör esetében illessze be az erőforráshoz tartozó kapcsolati karakterláncot, és szükség esetén adja meg a kis-és nagybetűket megkülönböztető esemény hub, üzenetsor vagy témakör nevét.For Azure Event Hubs, Azure Service Bus queue or topic, paste the connection string for your resource, and enter the case-sensitive event hub, queue, or topic name if necessary.
    • Az Azure Blob Storage esetében illessze be az erőforráshoz tartozó kapcsolatok karakterláncát, és ha szükséges, adja meg a kis-és nagybetűket megkülönböztető tároló nevét.For Azure Blob Storage, paste the connection string for your resource and enter the case-sensitive container name if necessary.
    • Webhook esetén illessze be a webhook-végpont visszahívási URL-címét.For Webhook, paste the callback URL for your webhook endpoint. Igény szerint konfigurálhatja a webhook-engedélyezést (OAuth 2,0 és engedélyezési token), és hozzáadhat egyéni fejléceket.You can optionally configure webhook authorization (OAuth 2.0 and Authorization token) and add custom headers.
      • A OAuth 2,0 esetében csak az ügyfél-hitelesítő adatok folyamata támogatott.For OAuth 2.0, only the client credentials flow is supported. A célhely mentésekor a IoT Central kommunikálni fog a OAuth szolgáltatójával egy engedélyezési jogkivonat lekéréséhez.When the destination is saved, IoT Central will communicate with your OAuth provider to retrieve an authorization token. Ez a jogkivonat a célhelyre küldött összes üzenet "Authorization" fejlécéhez lesz csatolva.This token will be attached to the "Authorization" header for every message sent to this destination.
      • Az engedélyezési jogkivonat esetében megadhat egy jogkivonat-értéket, amely közvetlenül az adott célhelyre küldött összes üzenet "engedélyezés" fejlécéhez lesz csatolva.For Authorization token, you can specify a token value that will be directly attached to the "Authorization" header for every message sent to this destination.
    • Válassza a Létrehozás lehetőséget.Select Create.
  9. Válassza a + cél lehetőséget, és válasszon egy célhelyet a legördülő listából.Select + Destination and choose a destination from the dropdown. Legfeljebb öt célhelyet adhat hozzá egyetlen exportáláshoz.You can add up to five destinations to a single export.

  10. Ha végzett az Exportálás beállításával, válassza a Mentés lehetőséget.When you've finished setting up your export, select Save. Néhány perc elteltével az adatai megjelennek a célhelyen.After a few minutes, your data appears in your destinations.

Az Exportálás figyeléseMonitor your export

A IoT Centralban lévő exportálások állapotának megtekintése mellett a Azure monitor használatával megtekintheti, hogy mennyi adattal exportálja, és milyen exportálási hibákba ütközik.In addition to seeing the status of your exports in IoT Central, you can use Azure Monitor to see how much data you're exporting and any export errors. Az exportálási és az Eszközállapot-metrikákat a Azure Portalban lévő diagramokon REST API, a PowerShellben vagy az Azure CLI-ben lévő lekérdezésekkel érheti el.You can access export and device health metrics in charts in the Azure portal, with a REST API, or with queries in PowerShell or the Azure CLI. Jelenleg a következő adatexportálási metrikákat figyelheti Azure Monitorban:Currently, you can monitor the following data export metrics in Azure Monitor:

  • Az exportáláshoz bejövő üzenetek száma a szűrők alkalmazása előtt.Number of messages incoming to export before filters are applied.
  • A szűrőkkel továbbított üzenetek száma.Number of messages that pass through filters.
  • A célhelyekre sikeresen exportált üzenetek száma.Number of messages successfully exported to destinations.
  • Az észlelt hibák száma.Number of errors encountered.

További információ: IoT Central alkalmazások általános állapotának figyelése.To learn more, see Monitor the overall health of an IoT Central application.

CélhelyekDestinations

Azure Blob Storage célhelyAzure Blob Storage destination

Az adatexportálás percenként egyszer történik, és minden olyan fájl, amely az előző exportálás óta változást tartalmaz.Data is exported once per minute, with each file containing the batch of changes since the previous export. Az exportált adatfájlok JSON formátumban lesznek mentve.Exported data is saved in JSON format. A Storage-fiókban található exportált adatelérési utak a következők:The default paths to the exported data in your storage account are:

  • Telemetria: {Container}/{app-id}/{partition_id}/{yyyy}/{MM}/{DD}/{hh}/{mm}/{filename}Telemetry: {container}/{app-id}/{partition_id}/{YYYY}/{MM}/{dd}/{hh}/{mm}/{filename}
  • Tulajdonságok módosítása: {Container}/{app-id}/{partition_id}/{yyyy}/{MM}/{DD}/{hh}/{mm}/{filename}Property changes: {container}/{app-id}/{partition_id}/{YYYY}/{MM}/{dd}/{hh}/{mm}/{filename}

Az exportált fájlok tallózásához a Azure Portal navigáljon a fájlhoz, és válassza a blob szerkesztése lehetőséget.To browse the exported files in the Azure portal, navigate to the file and select Edit blob.

Azure Event Hubs és Azure Service Bus célhelyekAzure Event Hubs and Azure Service Bus destinations

Az adatexportálás közel valós időben történik.Data is exported in near real time. Az adattartalom az üzenet törzsében van, és JSON formátumú, UTF-8 kódolású.The data is in the message body and is in JSON format encoded as UTF-8.

Az üzenet jegyzetek vagy Rendszertulajdonságok táska tartalmazza a,, iotcentral-device-id iotcentral-application-id iotcentral-message-source és iotcentral-message-type mezőket, amelyek az üzenettörzs megfelelő mezőivel megegyező értékekkel rendelkeznek.The annotations or system properties bag of the message contains the iotcentral-device-id, iotcentral-application-id, iotcentral-message-source, and iotcentral-message-type fields that have the same values as the corresponding fields in the message body.

Webhook célhelyeWebhook destination

Webhookok célhelye esetén a rendszer a közel valós időben is exportálja az adategységeket.For webhooks destinations, data is also exported in near real time. Az üzenet törzsében lévő adatformátum megegyezik a Event Hubs és Service Bus.The data in the message body is in the same format as for Event Hubs and Service Bus.

Telemetria formátumaTelemetry format

Minden exportált üzenet a teljes üzenet normalizált formáját tartalmazza, amelyet az eszköz küld az üzenet törzsében.Each exported message contains a normalized form of the full message the device sent in the message body. Az üzenet JSON formátumú, és UTF-8-ként van kódolva.The message is in JSON format and encoded as UTF-8. Az egyes üzenetekben található információk a következők:Information in each message includes:

  • applicationId: A IoT Central alkalmazás azonosítója.applicationId: The ID of the IoT Central application.
  • messageSource: Az üzenet forrása – telemetry .messageSource: The source for the message - telemetry.
  • deviceId: Annak az eszköznek az azonosítója, amely elküldte a telemetria üzenetet.deviceId: The ID of the device that sent the telemetry message.
  • schema: A hasznos adatok sémájának neve és verziószáma.schema: The name and version of the payload schema.
  • templateId: Az eszközhöz társított eszköz sablonjának azonosítója.templateId: The ID of the device template associated with the device.
  • enqueuedTime: Az az idő, amikor a IoT Central megkapta az üzenetet.enqueuedTime: The time at which this message was received by IoT Central.
  • enrichments: Az exportáláskor beállított alkoholtartalom-NÖVELÉSEK.enrichments: Any enrichments set up on the export.
  • messageProperties: Az eszköz által az üzenettel küldött további tulajdonságok.messageProperties: Additional properties that the device sent with the message. Ezeket a tulajdonságokat más néven az alkalmazás tulajdonságai is nevezik.These properties are sometimes referred to as application properties. További információ: IoT hub docs.Learn more from IoT Hub docs.

Event Hubs és Service Bus esetén a IoT Central gyorsan exportál egy új üzenetet, miután megkapta az üzenetet az eszközről.For Event Hubs and Service Bus, IoT Central exports a new message quickly after it receives the message from a device. A felhasználó tulajdonságaiban (más néven az alkalmazás tulajdonságai) minden üzenet, a iotcentral-device-id , iotcentral-application-id és iotcentral-message-source automatikusan szerepel.In the user properties (also referred to as application properties) of each message, the iotcentral-device-id, iotcentral-application-id, and iotcentral-message-source are included automatically.

A blob Storage esetében az üzenetek kötegbe kerülnek, és percenként egyszer lesznek exportálva.For Blob storage, messages are batched and exported once per minute.

Az alábbi példa egy exportált telemetria üzenetet mutat be:The following example shows an exported telemetry message:


{
    "applicationId": "1dffa667-9bee-4f16-b243-25ad4151475e",
    "messageSource": "telemetry",
    "deviceId": "1vzb5ghlsg1",
    "schema": "default@v1",
    "templateId": "urn:qugj6vbw5:___qbj_27r",
    "enqueuedTime": "2020-08-05T22:26:55.455Z",
    "telemetry": {
        "Activity": "running",
        "BloodPressure": {
            "Diastolic": 7,
            "Systolic": 71
        },
        "BodyTemperature": 98.73447010562934,
        "HeartRate": 88,
        "HeartRateVariability": 17,
        "RespiratoryRate": 13
    },
    "enrichments": {
      "userSpecifiedKey": "sampleValue"
    },
    "messageProperties": {
      "messageProp": "value"
    }
}

Üzenet tulajdonságaiMessage properties

A telemetria-üzenetek a telemetria-adattartalom mellett metaadatokat is tartalmazhatnak.Telemetry messages have properties for metadata in addition to the telemetry payload. Az előző kódrészlet példákat mutat be a rendszerüzenetekre, például a és a szolgáltatásra deviceId enqueuedTime .The previous snippet shows examples of system messages such as deviceId and enqueuedTime. Ha többet szeretne megtudni a rendszerüzenetek tulajdonságairól, tekintse meg a D2C IoT hub üzeneteinek rendszertulajdonságait.To learn more about the system message properties, see System Properties of D2C IoT Hub messages.

Ha egyéni metaadatokat kell hozzáadnia a telemetria-üzenetekhez, hozzáadhat tulajdonságokat a telemetria-üzenetekhez.You can add properties to telemetry messages if you need to add custom metadata to your telemetry messages. Például ha az eszköz létrehozza az üzenetet, hozzá kell adnia egy időbélyeget.For example, you need to add a timestamp when the device creates the message.

A következő kódrészletből megtudhatja, hogyan adhatja hozzá a iothub-creation-time-utc tulajdonságot az üzenethez, amikor létrehozza azt az eszközön:The following code snippet shows how to add the iothub-creation-time-utc property to the message when you create it on the device:

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);
}

A következő kódrészlet ezt a tulajdonságot mutatja be a blob Storage-ba exportált üzenetben:The following snippet shows this property in the message exported to Blob storage:

{
  "applicationId":"5782ed70-b703-4f13-bda3-1f5f0f5c678e",
  "messageSource":"telemetry",
  "deviceId":"sample-device-01",
  "schema":"default@v1",
  "templateId":"urn:modelDefinition:mkuyqxzgea:e14m1ukpn",
  "enqueuedTime":"2021-01-29T16:45:39.143Z",
  "telemetry":{
    "temperature":8.341033560421833
  },
  "messageProperties":{
    "iothub-creation-time-utc":"2021-01-29T16:45:39.021Z"
  },
  "enrichments":{}
}

Tulajdonság módosításainak formátumaProperty changes format

Minden üzenet vagy rekord egy eszköz vagy egy Felhőbeli tulajdonság egyik módosítását jelöli.Each message or record represents one change to a device or cloud property. Az eszköz tulajdonságainál csak a jelentett érték változásai lesznek exportálva külön üzenetként.For device properties, only changes in the reported value are exported as a separate message. Az exportált üzenetben szereplő információk a következők:Information in the exported message includes:

  • applicationId: A IoT Central alkalmazás azonosítója.applicationId: The ID of the IoT Central application.
  • messageSource: Az üzenet forrása – properties .messageSource: The source for the message - properties.
  • messageType: Vagy cloudPropertyChange , devicePropertyDesiredChange , vagy devicePropertyReportedChange .messageType: Either cloudPropertyChange, devicePropertyDesiredChange, or devicePropertyReportedChange.
  • deviceId: Annak az eszköznek az azonosítója, amely elküldte a telemetria üzenetet.deviceId: The ID of the device that sent the telemetry message.
  • schema: A hasznos adatok sémájának neve és verziószáma.schema: The name and version of the payload schema.
  • enqueuedTime: IoT Central által észlelt változás időpontja.enqueuedTime: The time at which this change was detected by IoT Central.
  • templateId: Az eszközhöz társított eszköz sablonjának azonosítója.templateId: The ID of the device template associated with the device.
  • enrichments: Az exportáláskor beállított alkoholtartalom-NÖVELÉSEK.enrichments: Any enrichments set up on the export.

Event Hubs és Service Bus esetén IoT Central az új üzenetek adatait az Event hub-ba vagy a Service Bus üzenetsor vagy témakörbe exportálja közel valós időben.For Event Hubs and Service Bus, IoT Central exports new messages data to your event hub or Service Bus queue or topic in near real time. Az egyes üzenetek felhasználói tulajdonságaiban (más néven az alkalmazás tulajdonságai) a, a, iotcentral-device-id a iotcentral-application-id iotcentral-message-source és a iotcentral-message-type automatikusan szerepel.In the user properties (also referred to as application properties) of each message, the iotcentral-device-id, iotcentral-application-id, iotcentral-message-source, and iotcentral-message-type are included automatically.

A blob Storage esetében az üzenetek kötegbe kerülnek, és percenként egyszer lesznek exportálva.For Blob storage, messages are batched and exported once per minute.

Az alábbi példa egy exportált tulajdonság-módosítási üzenetet mutat be az Azure Blob Storageban.The following example shows an exported property change message received in Azure Blob Storage.

{
    "applicationId": "1dffa667-9bee-4f16-b243-25ad4151475e",
    "messageSource": "properties",
    "messageType": "cloudPropertyChange",
    "deviceId": "18a985g1fta",
    "schema": "default@v1",
    "templateId": "urn:qugj6vbw5:___qbj_27r",
    "enqueuedTime": "2020-08-05T22:37:32.942Z",
    "properties": [{
        "name": "MachineSerialNumber",
        "value": "abc"
    }],
    "enrichments": {
        "userSpecifiedKey" : "sampleValue"
    }
}

Eszköz életciklusának változási formátumaDevice lifecycle changes format

Minden üzenet vagy rekord egyetlen eszközre való váltást jelöl.Each message or record represents one change to a single device. Az exportált üzenetben szereplő információk a következők:Information in the exported message includes:

  • applicationId: A IoT Central alkalmazás azonosítója.applicationId: The ID of the IoT Central application.
  • messageSource: Az üzenet forrása – deviceLifecycle .messageSource: The source for the message - deviceLifecycle.
  • messageType: registered Vagy vagy deleted .messageType: Either registered or deleted.
  • deviceId: A módosított eszköz azonosítója.deviceId: The ID of the device that was changed.
  • schema: A hasznos adatok sémájának neve és verziószáma.schema: The name and version of the payload schema.
  • templateId: Az eszközhöz társított eszköz sablonjának azonosítója.templateId: The ID of the device template associated with the device.
  • enqueuedTime: Az az idő, amikor a változás bekövetkezett IoT Centralban.enqueuedTime: The time at which this change occurred in IoT Central.
  • enrichments: Az exportáláskor beállított alkoholtartalom-NÖVELÉSEK.enrichments: Any enrichments set up on the export.

Event Hubs és Service Bus esetén IoT Central az új üzenetek adatait az Event hub-ba vagy a Service Bus üzenetsor vagy témakörbe exportálja közel valós időben.For Event Hubs and Service Bus, IoT Central exports new messages data to your event hub or Service Bus queue or topic in near real time. Az egyes üzenetek felhasználói tulajdonságaiban (más néven az alkalmazás tulajdonságai) a, a, iotcentral-device-id a iotcentral-application-id iotcentral-message-source és a iotcentral-message-type automatikusan szerepel.In the user properties (also referred to as application properties) of each message, the iotcentral-device-id, iotcentral-application-id, iotcentral-message-source, and iotcentral-message-type are included automatically.

A blob Storage esetében az üzenetek kötegbe kerülnek, és percenként egyszer lesznek exportálva.For Blob storage, messages are batched and exported once per minute.

Az alábbi példa egy, az Azure Blob Storageban fogadott exportált eszköz életciklusára vonatkozó üzenetet jelenít meg.The following example shows an exported device lifecycle message received in Azure Blob Storage.

{
  "applicationId": "1dffa667-9bee-4f16-b243-25ad4151475e",
  "messageSource": "deviceLifecycle",
  "messageType": "registered",
  "deviceId": "1vzb5ghlsg1",
  "schema": "default@v1",
  "templateId": "urn:qugj6vbw5:___qbj_27r",
  "enqueuedTime": "2021-01-01T22:26:55.455Z",
  "enrichments": {
    "userSpecifiedKey": "sampleValue"
  }
}

Az eszköz sablonjának életciklus-változási formátumaDevice template lifecycle changes format

Minden üzenet vagy rekord egyetlen közzétett sablon egyetlen módosítását jelöli.Each message or record represents one change to a single published device template. Az exportált üzenetben szereplő információk a következők:Information in the exported message includes:

  • applicationId: A IoT Central alkalmazás azonosítója.applicationId: The ID of the IoT Central application.
  • messageSource: Az üzenet forrása – deviceTemplateLifecycle .messageSource: The source for the message - deviceTemplateLifecycle.
  • messageType: Vagy created , updated , vagy deleted .messageType: Either created, updated, or deleted.
  • schema: A hasznos adatok sémájának neve és verziószáma.schema: The name and version of the payload schema.
  • templateId: Az eszközhöz társított eszköz sablonjának azonosítója.templateId: The ID of the device template associated with the device.
  • enqueuedTime: Az az idő, amikor a változás bekövetkezett IoT Centralban.enqueuedTime: The time at which this change occurred in IoT Central.
  • enrichments: Az exportáláskor beállított alkoholtartalom-NÖVELÉSEK.enrichments: Any enrichments set up on the export.

Event Hubs és Service Bus esetén IoT Central az új üzenetek adatait az Event hub-ba vagy a Service Bus üzenetsor vagy témakörbe exportálja közel valós időben.For Event Hubs and Service Bus, IoT Central exports new messages data to your event hub or Service Bus queue or topic in near real time. Az egyes üzenetek felhasználói tulajdonságaiban (más néven az alkalmazás tulajdonságai) a, a, iotcentral-device-id a iotcentral-application-id iotcentral-message-source és a iotcentral-message-type automatikusan szerepel.In the user properties (also referred to as application properties) of each message, the iotcentral-device-id, iotcentral-application-id, iotcentral-message-source, and iotcentral-message-type are included automatically.

A blob Storage esetében az üzenetek kötegbe kerülnek, és percenként egyszer lesznek exportálva.For Blob storage, messages are batched and exported once per minute.

Az alábbi példa egy, az Azure Blob Storageban fogadott exportált eszköz életciklusára vonatkozó üzenetet jelenít meg.The following example shows an exported device lifecycle message received in Azure Blob Storage.

{
  "applicationId": "1dffa667-9bee-4f16-b243-25ad4151475e",
  "messageSource": "deviceTemplateLifecycle",
  "messageType": "created",
  "schema": "default@v1",
  "templateId": "urn:qugj6vbw5:___qbj_27r",
  "enqueuedTime": "2021-01-01T22:26:55.455Z",
  "enrichments": {
    "userSpecifiedKey": "sampleValue"
  }
}

A régi adatexportálás és az adatexportálás összehasonlításaComparison of legacy data export and data export

Az alábbi táblázat az örökölt adatexportálás és az új adatexportálási funkciók közötti különbségeket mutatja be:The following table shows the differences between the legacy data export and the new data export features:

KépességekCapabilities Örökölt adatexportálásLegacy data export Új adatexportálásNew data export
Elérhető adattípusokAvailable data types Telemetria, eszközök, eszközök sablonjaiTelemetry, Devices, Device templates Telemetria, a tulajdonságok változásai, az eszköz életciklusának változásai, az eszköz sablonjának életciklusának változásaiTelemetry, Property changes, Device lifecycle changes, Device template lifecycle changes
SzűrésFiltering NincsenekNone Az exportált adattípustól függ.Depends on the data type exported. Telemetria, szűrés telemetria, üzenet tulajdonságai, tulajdonságértékek alapjánFor telemetry, filtering by telemetry, message properties, property values
ModellbővítésekEnrichments NincsenekNone Gazdagítsa az eszköz egyéni sztringjét vagy tulajdonságának értékétEnrich with a custom string or a property value on the device
CélhelyekDestinations Azure Event Hubs, Azure Service Bus várólisták és témakörök, Azure Blob StorageAzure Event Hubs, Azure Service Bus queues and topics, Azure Blob Storage Ugyanaz, mint a korábbi adatexportáláshoz és webhookokhozSame as for legacy data export plus webhooks
Támogatott alkalmazások verzióiSupported application versions V2, V3V2, V3 Csak v3V3 only
Jelentős korlátokNotable limits 5 export/alkalmazás, 1 cél/exportálás5 exports per app, 1 destination per export 10 exportálás – cél kapcsolatok száma alkalmazás szerint10 exports-destination connections per app

Következő lépésekNext steps

Most, hogy már tudja, hogyan használhatja az új adatexportálást, egy javasolt következő lépés az elemzések használatának megismerése IoT CentralNow that you know how to use the new data export, a suggested next step is to learn How to use analytics in IoT Central