Manage and monitor IoT Central from the Azure portal

You can use the Azure portal to create, manage, and monitor IoT Central applications.

Create IoT Central applications

Warning

You'll need Contributor access to your Azure Subscription to create an IoT Central app. While there may be alternative access levels to create an app, having Contributor level access to the Subscription is the recommended path.

To create an application, navigate to the IoT Central Application page in the Azure portal:

Create IoT Central form

  • Resource name is a unique name you can choose for your IoT Central application in your Azure resource group.

  • Application URL is the URL you can use to access your application.

  • Template is the type of IoT Central application you want to create. You can create a new application either from the list of industry-relevant templates to help you get started quickly, or start from scratch using the Custom application template.

  • Location is the Azure region where you'd like to create your application. Typically, you should choose the location that's physically closest to your devices to get optimal performance. Azure IoT Central is currently available in the following locations:

    • Australia East
    • Canada Central
    • Central US
    • East US
    • East US 2
    • Japan East
    • North Europe
    • South Central US
    • Southeast Asia
    • UK South
    • West Europe
    • West US

    Once you choose a location, you can't later move your application to a different location.

After filling out all fields, select Create. To learn more, see Create an IoT Central application.

Manage existing IoT Central applications

If you already have an Azure IoT Central application, you can delete it, or move it to a different subscription or resource group in the Azure portal.

Note

Applications created using the free plan do not require an Azure subscriptions, and therefore you won't find them listed in your Azure subscription on the Azure portal. You can only see and manage free apps from the IoT Central portal.

To get started, search for your application in the search bar at the top of the Azure portal. You can also view all your applications by searching for IoT Central Applications and selecting the service:

Screenshot that shows the search results for "IoT Central Applications" with the first service selected.

When you select an application in the search results, the Azure portal shows you its overview. You can navigate to the application by selecting the IoT Central Application URL:

Screenshot that shows the "Overview" page with the "IoT Central Application URL" highlighted.

Note

Use the IoT Central Application URL to access the application for the first time.

To move the application to a different resource group, select change beside the resource group. On the Move resources page, choose the resource group you'd like to move this application to:

Screenshot that shows the "Overview" page with the "Resource group (change)" highlighted.

To move the application to a different subscription, select change beside the subscription. On the Move resources page, choose the subscription you'd like to move this application to:

Management portal: resource management

Configure a managed identity

When you configure a data export in your IoT Central application, you can choose to configure the connection to the destination with a connection string or a managed identity. Managed identities are more secure because:

  • You don't store the credentials for your resource in a connection string in your IoT Central application.
  • The credentials are automatically tied to the lifetime of your IoT Central application.
  • Managed identities automatically rotate their security keys regularly.

IoT Central currently uses system-assigned managed identities. To create the managed identity for your application, you use either the Azure portal or the REST API.

Note

You can only add a managed identity to an IoT Central application that was created in a region. All new applications are created in a region. To learn more, see Updates.

When you configure a managed identity, the configuration includes a scope and a role:

  • The scope defines where you can use the managed identity. For example, you can use an Azure resource group as the scope. In this case, both the IoT Central application and the destination must be in the same resource group.
  • The role defines what permissions the IoT Central application is granted in the destination service. For example, for an IoT Central application to send data to an event hub, the managed identity needs the Azure Event Hubs Data Sender role assignment.

To configure the managed identity that enables your IoT Central application to securely export data to your Azure resource:

  1. In the Azure portal, navigate to your IoT Central application.

    Tip

    By default, IoT Central applications are created in the IOTC resource group in your subscription.

  2. Select Identity. Then on the System assigned page, change the status to On, and then select Save.

  3. After a few seconds, the system assigned managed identity for your IoT Central application is enabled and you can select Azure role assignments:

    Screenshot of identity page for IoT Central application in the Azure portal.

  4. On the Azure role assignments page, select + Add role assignment.

You can configure role assignments in the Azure portal or use the Azure CLI:

Monitor application health

You can use the set of metrics provided by IoT Central to assess the health of devices connected to your IoT Central application and the health of your running data exports.

Metrics are enabled by default for your IoT Central application and you access them from the Azure portal. The Azure Monitor data platform exposes these metrics and provides several ways for you to interact with them. For example, you can use charts in the Azure portal, a REST API, or queries in PowerShell or the Azure CLI.

Tip

Applications that use the free trial plan don't have an associated Azure subscription and so don't support Azure Monitor metrics. You can convert an application to a standard pricing plan and get access to these metrics.

View metrics in the Azure portal

The following steps assume you have an IoT Central application with some connected devices or a running data export.

To view IoT Central metrics in the portal:

  1. Navigate to your IoT Central application resource in the portal. By default, IoT Central resources are located in a resource group called IOTC.
  2. To create a chart from your application's metrics, select Metrics in the Monitoring section.

Azure Metrics

Azure portal permissions

Access to metrics in the Azure portal is managed by Azure role based access control. Use the Azure portal to add users to the IoT Central application/resource group/subscription to grant them access. You must add a user in the portal even they're already added to the IoT Central application. Use Azure built-in roles for finer grained access control.

IoT Central metrics

For a list of the metrics that are currently available for IoT Central, see Supported metrics with Azure Monitor.

Metrics and invoices

Metrics may differ from the numbers shown on your Azure IoT Central invoice. This situation occurs for a number of reasons such as:

  • IoT Central standard pricing plans include two devices and varying message quotas for free. While the free items are excluded from billing, they're still counted in the metrics.

  • IoT Central autogenerates one test device ID for each device template in the application. This device ID is visible on the Manage test device page for a device template. You may choose to validate your device templates before publishing them by generating code that uses these test device IDs. While these devices are excluded from billing, they're still counted in the metrics.

  • While metrics may show a subset of device-to-cloud communication, all communication between the device and the cloud counts as a message for billing.

Monitor connected IoT Edge devices

To learn how to remotely monitor your IoT Edge fleet using Azure Monitor and built-in metrics integration, see Collect and transport metrics.

Next steps

Now that you've learned how to manage and monitor Azure IoT Central applications from the Azure portal, here is the suggested next step: