Skip to content

Commit 048fbc4

Browse files
committed
Tidy up
1 parent 3ad883b commit 048fbc4

File tree

8 files changed

+12
-124
lines changed

8 files changed

+12
-124
lines changed

articles/iot-operations/discover-manage-assets/howto-manage-assets-remotely.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ This article describes how to use the operations experience web UI and the Azure
3131
- Define the asset endpoints that connect assets to your Azure IoT Operations instance.
3232
- Add assets, and define their tags and events to enable dataflow from OPC UA servers to the MQTT broker.
3333

34-
These assets, tags, and events map inbound data from OPC UA servers to friendly names that you can use in the MQTT broker and data processor pipelines.
34+
These assets, tags, and events map inbound data from OPC UA servers to friendly names that you can use in the MQTT broker and dataflows.
3535

3636
## Prerequisites
3737

@@ -126,7 +126,7 @@ To learn more, see [az iot ops asset endpoint](/cli/azure/iot/ops/asset/endpoint
126126

127127
This configuration deploys a new `assetendpointprofile` resource called `opc-ua-connector-0` to the cluster. After you define an asset, a connector for OPC UA pod discovers it. The pod uses the asset endpoint that you specify in the asset definition to connect to an OPC UA server.
128128

129-
When the OPC PLC simulator is running, data flows from the simulator, to the connector for OPC UA, and then to the MQTT broker.
129+
When the OPC PLC simulator is running, dataflows from the simulator, to the connector for OPC UA, and then to the MQTT broker.
130130

131131
### Configure an asset endpoint to use a username and password
132132

articles/iot-operations/discover-manage-assets/overview-manage-assets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ The following diagram shows the high-level architecture of Azure IoT Operations.
3636

3737
- The **operations experience** is a web UI that lets you create and configure assets in your solution. The web UI simplifies the task of managing assets and is the recommended service to manage assets.
3838
- **Azure Device Registry Preview** is a backend service that enables the cloud and edge management of assets. Device Registry projects assets defined in your edge environment as Azure resources in the cloud. It provides a single unified registry so that all apps and services that interact with your assets can connect to a single source. Device Registry also manages the synchronization between assets in the cloud and assets as custom resources in Kubernetes on the edge.
39-
- The schema registry is a service that lets you define and manage the schema for your assets. Data flows use schemas to deserialize and serialize messages.
39+
- The schema registry is a service that lets you define and manage the schema for your assets. Dataflows use schemas to deserialize and serialize messages.
4040
- The **connector for OPC UA** is a data ingress and protocol translation service that enables Azure IoT Operations to ingress data from your assets. The broker receives telemetry and events from your assets and publishes the data to topics in the MQTT broker. The broker is based on the widely used OPC UA standard.
4141

4242
## Create and manage assets remotely

articles/iot-operations/get-started-end-to-end-sample/quickstart-add-assets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Unless otherwise noted, you can run the console commands in this quickstart in e
3333

3434
## What problem will we solve?
3535

36-
The data that OPC UA servers expose can have a complex structure and can be difficult to understand. Azure IoT Operations provides a way to model OPC UA assets as tags, events, and properties. This modeling makes it easier to understand the data and to use it in downstream processes such as the MQTT broker and data processor pipelines.
36+
The data that OPC UA servers expose can have a complex structure and can be difficult to understand. Azure IoT Operations provides a way to model OPC UA assets as tags, events, and properties. This modeling makes it easier to understand the data and to use it in downstream processes such as the MQTT broker and dataflows.
3737

3838
## Deploy the OPC PLC simulator
3939

articles/iot-operations/includes/add-cluster-secret.md

Lines changed: 0 additions & 65 deletions
This file was deleted.

articles/iot-operations/manage-mqtt-broker/overview-iot-mq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Publish and subscribe MQTT messages using MQTT broker
3-
description: Use MQTT broker to publish and subscribe to messages. Destinations include other MQTT brokers, Azure IoT Data Processor, and Azure cloud services.
3+
description: Use MQTT broker to publish and subscribe to messages. Destinations include other MQTT brokers, dataflows, and Azure cloud services.
44
author: PatAltimore
55
ms.author: patricka
66
ms.subservice: azure-mqtt-broker

articles/iot-operations/overview-iot-operations.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ There are two core elements in the Azure IoT Operations Preview architecture:
3535
* **Azure IoT Operations Preview**. The set of data services that run on Azure Arc-enabled edge Kubernetes clusters. It includes the following services:
3636
* The _MQTT broker_ is an edge-native MQTT broker that powers event-driven architectures.
3737
* The _connector for OPC UA_ handles the complexities of OPC UA communication with OPC UA servers and other leaf devices.
38-
* The _operations experience_ is a web UI that provides a unified experience for operational technologists to manage assets and data processor pipelines in an Azure IoT Operations deployment. An IT administrator can use [Azure Arc site manager (preview)](../azure-arc/site-manager/overview.md) to group Azure IoT Operations instances by physical location and make it easier for OT users to find instances.
38+
* The _operations experience_ is a web UI that provides a unified experience for operational technologists to manage assets and dataflows in an Azure IoT Operations deployment. An IT administrator can use [Azure Arc site manager (preview)](../azure-arc/site-manager/overview.md) to group Azure IoT Operations instances by physical location and make it easier for OT users to find instances.
3939

4040
## Deploy
4141

@@ -66,7 +66,7 @@ The [MQTT broker](manage-mqtt-broker/overview-iot-mq.md) runs on the edge. It le
6666
Examples of how components in Azure IoT Operations use the MQTT broker include:
6767

6868
* The connector for OPC UA publishes data from OPC UA servers and other leaf devices to MQTT topics.
69-
* Data processor pipelines subscribe to MQTT topics to retrieve messages for processing.
69+
* Dataflows subscribe to MQTT topics to retrieve messages for processing.
7070
* Northbound cloud connectors subscribe to MQTT topics to fetch messages for forwarding to cloud services.
7171

7272
## Connect to the cloud
@@ -81,7 +81,7 @@ The northbound cloud connectors let you connect the MQTT broker directly to clou
8181

8282
## Process data
8383

84-
In Azure IoT operations v0.6.0, the data processor is replaced by [data flows](./connect-to-cloud/overview-dataflow.md). Data flows provide enhanced data transformation and data contextualization capabilities within Azure IoT Operations. Data flows can use schemas stored in the schema registry to deserialize and serialize messages.
84+
In Azure IoT operations v0.6.0, the data processor is replaced by [dataflows](./connect-to-cloud/overview-dataflow.md). Dataflows provide enhanced data transformation and data contextualization capabilities within Azure IoT Operations. Dataflows can use schemas stored in the schema registry to deserialize and serialize messages.
8585

8686
> [!NOTE]
8787
> If you want to continue using the data processor, you must deploy Azure IoT Operations v0.5.1 with the additional flag to include data processor component. It's not possible to deploy the data processor with Azure IoT Operations v0.6.0. The Azure IoT operations CLI extension that includes the flag for deploying the data processor is version 0.5.1b1. This version requires Azure CLI v2.46.0 or greater. The data processor documentation is currently available on the previous versions site: [Azure IoT Operations data processor](/previous-versions/azure/iot-operations/process-data/overview-data-processor).

articles/iot-operations/reference/glossary.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,9 @@ A unified data plane for the edge. It's a collection of modular, scalable, and h
2727

2828
On first mention in an article, use _Azure IoT Operations Preview - enabled by Azure Arc_. On subsequent mentions, you can use _Azure IoT Operations_. Never use an acronym.
2929

30-
### Data processor
30+
### Dataflows
3131

32-
This component lets you aggregate, enrich, normalize, and filter the data from your devices and assets. The data processor is a pipeline-based data processing engine that lets you process data at the edge before you send it to the other services either at the edge or in the cloud
32+
This component lets you aggregate, enrich, normalize, and filter the data from your devices and assets. The dataflows is a data processing engine that lets you process data at the edge before you send it to the other services either at the edge or in the cloud
3333

3434
### Azure IoT Layered Network Management Preview
3535

@@ -47,7 +47,7 @@ This component manages the connection to OPC UA servers and other leaf devices.
4747

4848
### Operations experience
4949

50-
This web UI provides a unified experience for operational technologists to manage assets and data processor pipelines in an Azure IoT Operations deployment.
50+
This web UI provides a unified experience for operational technologists to manage assets and dataflows in an Azure IoT Operations deployment.
5151

5252
### Azure Device Registry Preview
5353

articles/iot-operations/troubleshoot/troubleshoot.md

Lines changed: 1 addition & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -19,59 +19,12 @@ This article contains troubleshooting tips for Azure IoT Operations Preview.
1919

2020
For general deployment and configuration troubleshooting, you can use the Azure CLI IoT Operations *check* and *support* commands.
2121

22-
[Azure CLI version 2.46.0 or higher](/cli/azure/install-azure-cli) is required and the [Azure IoT Operations extension](/cli/azure/iot/ops) installed.
22+
[Azure CLI version 2.52.0 or higher](/cli/azure/install-azure-cli) is required and the [Azure IoT Operations extension](/cli/azure/iot/ops) installed.
2323

2424
- Use [az iot ops check](/cli/azure/iot/ops#az-iot-ops-check) to evaluate Azure IoT Operations service deployment for health, configuration, and usability. The *check* command can help you find problems in your deployment and configuration.
2525

2626
- Use [az iot ops support create-bundle](/cli/azure/iot/ops/support#az-iot-ops-support-create-bundle) to collect logs and traces to help you diagnose problems. The *support create-bundle* command creates a standard support bundle zip archive you can review or provide to Microsoft Support.
2727

28-
## Data processor pipeline deployment troubleshooting
29-
30-
If your data processor pipeline deployment status is showing as **Failed**, use the following commands to find the pipeline error codes.
31-
32-
To list the data processor pipeline deployments, run the following command:
33-
34-
```bash
35-
kubectl get pipelines -A
36-
```
37-
38-
The output from the pervious command looks like the following example:
39-
40-
```text
41-
NAMESPACE NAME AGE
42-
azure-iot-operations passthrough-data-pipeline 2d20h
43-
azure-iot-operations reference-data-pipeline 2d20h
44-
azure-iot-operations contextualized-data-pipeline 2d20h
45-
```
46-
47-
To view detailed information for a pipeline, run the following command:
48-
49-
```bash
50-
kubectl describe pipelines passthrough-data-pipeline -n azure-iot-operations
51-
```
52-
53-
The output from the previous command looks like the following example:
54-
55-
```text
56-
...
57-
Status:
58-
Provisioning Status:
59-
Error
60-
Code: <ErrorCode>
61-
Message: <ErrorMessage>
62-
Status: Failed
63-
Events: <none>
64-
```
65-
66-
If you see the following message when you try to access the **Pipelines** tab in the Azure IoT Operations (preview) portal:
67-
68-
_Data Processor not found in the current deployment. Please re-deploy with the additional argument to include the data processor._
69-
70-
You need to deploy Azure IoT Operations with the optional data processor component included. To do this, you need to add the `--include-dp` argument when you run the [az iot ops init](/cli/azure/iot/ops#az-iot-ops-init) command. You must use the `--include-dp` argument to include the data processor component when you first deploy Azure IoT Operations. You can't add this optional component to an existing deployment.
71-
72-
> [!TIP]
73-
> If you want to delete the Azure IoT Operations deployment but plan on reinstalling it on your cluster, use the [az iot ops delete](/cli/azure/iot/ops?az-iot-ops-delete) command.
74-
7528
## Azure IoT Layered Network Management Preview troubleshooting
7629

7730
The troubleshooting guidance in this section is specific to Azure IoT Operations when using the Layered Network Management component. For more information, see [How does Azure IoT Operations Preview work in layered network?](../manage-layered-network/concept-iot-operations-in-layered-network.md).

0 commit comments

Comments
 (0)