Skip to content

Commit 815e080

Browse files
authored
Merge pull request #194536 from dominicbetts/central-operator-guide
Update and expand IoT Central operator guide
2 parents 75436cf + 8ee1587 commit 815e080

File tree

3 files changed

+59
-19
lines changed

3 files changed

+59
-19
lines changed
101 KB
Loading
102 KB
Loading

articles/iot-central/core/overview-iot-central-operator.md

Lines changed: 59 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure IoT Central device management guide
33
description: Azure IoT Central is an IoT application platform that simplifies the creation of IoT solutions. This guide describes how to manage the IoT devices connected to your IoT Central application.
44
author: dominicbetts
55
ms.author: dobett
6-
ms.date: 01/04/2022
6+
ms.date: 04/07/2022
77
ms.topic: conceptual
88
ms.service: iot-central
99
services: iot-central
@@ -19,46 +19,86 @@ An IoT Central application lets you monitor and manage millions of devices throu
1919

2020
IoT Central lets you complete device management tasks such as:
2121

22+
- Provision new devices.
2223
- Monitor and manage the devices connected to the application.
2324
- Troubleshoot and remediate issues with devices.
24-
- Provision new devices.
2525

26-
## Search your devices
26+
You can use the following tools in your IoT Central application:
27+
28+
- The **Devices** page lets you monitor and manage individual devices.
29+
- The **Device groups** and **Data explorer** pages let you monitor aggregate data from your devices.
30+
- The **Jobs** page lets you manage your devices in bulk.
31+
- Custom dashboards let you manage and monitor devices in a way that suits you.
32+
- The REST API and Azure CLI enable you to automate device management tasks.
2733

28-
IoT Central lets you search devices by device name, ID, property value or cloud property value.
34+
## Search for devices
35+
36+
IoT Central lets you search devices by device name, ID, property value, or cloud property value:
2937

3038
:::image type="content" source="media/overview-iot-central-operator/search-devices.png" alt-text="Screenshot that shows how to search devices":::
3139

32-
## Monitor and manage devices
40+
## Add devices
3341

34-
:::image type="content" source="media/overview-iot-central-operator/simulated-telemetry.png" alt-text="Screenshot that shows a device view":::
42+
Use the **Devices** page to add individual devices, or [import devices](howto-manage-devices-in-bulk.md#import-devices) in bulk from a CSV file:
43+
44+
:::image type="content" source="media/overview-iot-central-operator/add-devices.png" alt-text="Screenshot that shows add device options.":::
45+
46+
## Group your devices
47+
48+
On the **Device groups** page, you can use queries to define groups of devices. You can use device groups to:
49+
50+
- Monitor aggregate data from devices on the **Device explorer** page.
51+
- Manage groups of devices in bulk by using jobs.
52+
- Control access to groups of devices if your application uses organizations.
53+
54+
To learn more, see [Tutorial: Use device groups to analyze device telemetry](tutorial-use-device-groups.md).
3555

36-
To monitor devices, use the custom device views defined by a solution builder. These views can show device telemetry and property values. An example is the **Overview** view shown in the previous screenshot.
56+
## Manage your devices
3757

38-
For more detailed information, use device groups and the built-in analytics features. To learn more, see [How to use data explorer to analyze device data](howto-create-analytics.md).
58+
Use the **Devices** page to manage individual devices connected to your application:
3959

40-
To manage individual devices, use device views to set device and cloud properties, and call device commands. Examples include the **Manage device** and **Commands** views in the previous screenshot.
60+
:::image type="content" source="media/overview-iot-central-operator/device-management-options​.png" alt-text="Screenshot showing the device management options.":::
4161

42-
To manage devices in bulk, create and schedule jobs. Jobs can update properties and run commands on multiple devices. To learn more, see [Create and run a job in your Azure IoT Central application](howto-manage-devices-in-bulk.md).
62+
For individual device, you can complete tasks such as [block or unblock it](howto-manage-devices-individually.md#device-status-values), [attach it to a gateway](tutorial-define-gateway-device-type.md), [approve it](howto-manage-devices-individually.md#device-status-values), [migrate it to a new device template](howto-edit-device-template.md#migrate-a-device-across-versions), [associate it with an organization](howto-create-organizations.md), and [generate a map to transform the incoming telemetry and properties](howto-map-data.md).
63+
64+
You can also set writable properties and cloud properties that are defined in the device template, and call commands on the device.
4365

4466
To manage IoT Edge devices, you can use the IoT Central UI to[create and edit deployment manifests](concepts-iot-edge.md#iot-edge-deployment-manifests-and-iot-central-device-templates), and then deploy them to your IoT Edge devices. You can also run commands in IoT Edge modules from within IoT Central.
4567

46-
If your IoT Central application uses *organizations*, an administrator controls which devices you have access to.
68+
Use the **Jobs** page to manage your devices in bulk. Jobs can update properties and run commands on multiple devices. To learn more, see [Manage devices in bulk in your Azure IoT Central application](howto-manage-devices-in-bulk.md).
4769

48-
## Troubleshoot and remediate issues
70+
> [!TIP]
71+
> If your IoT Central application uses *organizations*, an administrator controls which devices you have access to.
4972
50-
The [troubleshooting guide](troubleshoot-connection.md) helps you to diagnose and remediate common issues. You can use the **Devices** page to block devices that appear to be malfunctioning until the problem is resolved.
73+
## Monitor your devices
74+
75+
To monitor individual devices, use the custom device views on the **Devices** page. A solution builder defines these custom views as part of the [device template](concepts-device-templates.md). These views can show device telemetry and property values. An example is the **Overview** view shown in the following screenshot:
76+
77+
:::image type="content" source="media/overview-iot-central-operator/simulated-telemetry.png" alt-text="Screenshot that shows a device view":::
5178

52-
## Add and remove devices
79+
To monitor aggregate data from multiple devices, use device groups and the **Data explorer** page. To learn more, see [How to use data explorer to analyze device data](howto-create-analytics.md).
5380

54-
You can add and remove devices in your IoT Central application either individually or in bulk. To learn more, see:
81+
## Customize
5582

56-
- [Manage individual devices in your Azure IoT Central application](howto-manage-devices-individually.md).
57-
- [Manage devices in bulk in your Azure IoT Central application](howto-manage-devices-in-bulk.md).
83+
You can further customize the device management and monitoring experience using the following tools:
5884

59-
## Personalize
85+
- Create more views to display on the **Devices** page for individual devices by adding view definitions to your [device templates](concepts-device-templates.md).
86+
- Customize the text that describes your devices in the application. To learn more, see [Change application text](howto-customize-ui.md#change-application-text).
87+
- Create [custom device management dashboards](howto-manage-dashboards.md). A dashboard can include a [pinned query](howto-manage-dashboards.md#pin-analytics-to-dashboard) from the **Data explorer**.
6088

61-
Create personal dashboards in an IoT Central application that contain links to the resources you use most often. To learn more, see [Manage dashboards](howto-manage-dashboards.md).
89+
## Automate
90+
91+
To automate device management tasks, you can use:
92+
93+
- Rules to trigger actions automatically when device data that you're monitoring reaches predefined thresholds. To learn more, see [Configure rules](howto-configure-rules.md).
94+
- [Job scheduling](howto-manage-devices-in-bulk.md#create-and-run-a-job) for regular device management tasks.
95+
- The Azure CLI to manage your devices from a scripting environment. To learn more, see [az iot central](/cli/azure/iot/central).
96+
- The IoT Central REST API to manage your devices programmatically. To learn more, see [How to use the IoT Central REST API to manage devices](howto-manage-devices-with-rest-api.md).
97+
Rules, CLI, REST API, job schedule
98+
99+
## Troubleshoot and remediate device issues
100+
101+
The [troubleshooting guide](troubleshoot-connection.md) helps you to diagnose and remediate common issues. You can use the **Devices** page to block devices that appear to be malfunctioning until the problem is resolved.
62102

63103
## Next steps
64104

0 commit comments

Comments
 (0)