Skip to content

Commit 6c2e2b0

Browse files
Merge pull request #298353 from dominicbetts/aio-known-issues
AIO: Update known issues
2 parents 2b212f0 + 53a7544 commit 6c2e2b0

File tree

1 file changed

+56
-9
lines changed

1 file changed

+56
-9
lines changed

articles/iot-operations/troubleshoot/known-issues.md

Lines changed: 56 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Known issues for the MQTT broker, Layered Network Management (previ
44
author: dominicbetts
55
ms.author: dobett
66
ms.topic: troubleshooting-known-issue
7-
ms.date: 03/27/2025
7+
ms.date: 04/16/2025
88
---
99

1010
# Known issues: Azure IoT Operations
@@ -27,7 +27,7 @@ Log signature: `"code": "ExtensionOperationFailed", "message": "The extension op
2727

2828
---
2929

30-
If your deployment fails with the message `Error occurred while creating custom resources needed by system extensions`, you have encountered a known sporadic failure.
30+
The message `Error occurred while creating custom resources needed by system extensions` indicates that your deployment failed due to a known sporadic issue.
3131

3232
To work around this issue, use the `az iot ops delete` command with the `--include-deps` flag to delete Azure IoT Operations from your cluster. When Azure IoT Operations and its dependencies are deleted from your cluster, retry the deployment.
3333

@@ -59,7 +59,7 @@ Log signature: `"Message: Update failed for this resource, as there is a conflic
5959

6060
---
6161

62-
When you update Azure IoT Operations, the Helm package might enter a stuck state, preventing any helm install or upgrade operations from proceeding. This results in the error message `Update failed for this resource, as there is a conflicting operation in progress. Please try after sometime.`, which blocks further updates.
62+
When you update Azure IoT Operations, the Helm package might enter a stuck state, preventing any helm install or upgrade operations from proceeding. This scenario results in the error message `Update failed for this resource, as there is a conflicting operation in progress. Please try after sometime.`, which blocks further updates.
6363

6464
To work around this issue, follow these steps:
6565

@@ -185,7 +185,54 @@ Log signature: N/A
185185

186186
---
187187

188-
When you add a new asset with a new asset endpoint profile to the OPC UA broker and trigger a reconfiguration, the deployment of the `opc.tcp` pods changes to accommodate the new secret mounts for username and password. If the new mount fails for some reason, the pod does not restart and therefore the old flow for the correctly configured assets stops as well.
188+
When you add a new asset with a new asset endpoint profile to the OPC UA broker and trigger a reconfiguration, the deployment of the `opc.tcp` pods changes to accommodate the new secret mounts for username and password. If the new mount fails for some reason, the pod doesn't restart and therefore the old flow for the correctly configured assets stops as well.
189+
190+
### Data spike every 2.5 hours with some OPC UA simulators
191+
192+
---
193+
194+
Issue ID: 6513
195+
196+
---
197+
198+
Log signature: Increased message volume every 2.5 hours
199+
200+
---
201+
202+
Data values spike every 2.5 hours when using particular OPC UA simulators causing CPU and memory spikes. This issue isn't seen with OPC PLC simulator used in the quickstarts. No data is lost, but you can see an increase in the volume of data published from the server to the MQTT broker.
203+
204+
### No message schema generated if selected nodes in a dataset reference the same complex data type definition
205+
206+
---
207+
208+
Issue ID: 7369
209+
210+
---
211+
212+
Log signature: `An item with the same key has already been added. Key: <element name of the data type>`
213+
214+
---
215+
216+
No message schema is generated if selected nodes in a dataset reference the same complex data type definition (a UDT of type struct or enum).
217+
218+
If you select data points (node IDs) for a dataset that share non-OPC UA namespace complex type definitions (struct or enum), then the JSON schema isn't generated. The default open schema is shown when you create a data flow instead. For example, if the data set contains three values of a data type, then whether it works or not is shown in the following table. You can substitute `int` for any OPC UA built in type or primitive type such as `string`, `double`, `float`, or `long`:
219+
220+
| Type of Value 1 | Type of Value 2 | Type of Value 3 | Successfully generates schema |
221+
|-----------------|-----------------|-----------------|-----------------|
222+
| `int` | `int` | `int` | Yes |
223+
| `int` | `int` | `int` | Yes |
224+
| `int` | `int` | `struct A` | Yes |
225+
| `int` | `enum A` | `struct A` | Yes |
226+
| `enum A` | `enum B` | `enum C` | Yes |
227+
| `struct A` | `struct B` | `struct C` | Yes |
228+
| `int` | `struct A` | `struct A` | No |
229+
| `int` | `enum A` | `enum A` | No |
230+
231+
To work around this issue, you can either:
232+
233+
- Split the dataset across two or more assets.
234+
- Manually upload a schema.
235+
- Use the default nonschema experience in the data flow designer.
189236

190237
## Connector for media and connector for ONVIF issues
191238

@@ -203,7 +250,7 @@ Log signature: N/A
203250

204251
---
205252

206-
If you delete all the `Microsoft.Media` asset endpoint profiles the deployment for media processing is not deleted.
253+
If you delete all the `Microsoft.Media` asset endpoint profiles, the deployment for media processing isn't deleted.
207254
208255
To work around this issue, run the following command using the full name of your media connector deployment:
209256
@@ -223,7 +270,7 @@ Log signature: N/A
223270
224271
---
225272
226-
If you delete all the `Microsoft.Onvif` asset endpoint profiles the deployment for media processing is not deleted.
273+
If you delete all the `Microsoft.Onvif` asset endpoint profiles, the deployment for media processing isn't deleted.
227274

228275
To work around this issue, run the following command using the full name of your ONVIF connector deployment:
229276

@@ -243,9 +290,9 @@ Log signature: `"Error HelmUninstallUnknown: Helm encountered an error while att
243290

244291
---
245292

246-
Sometimes, when you attempt to uninstall Azure IoT Operations from the cluster, the system can get to a state where CRD removal job is stuck in pending state and that blocks cleanup of Azure IoT Operations.
293+
Sometimes, when you attempt to uninstall Azure IoT Operations from the cluster, the system can get to a state where CRD removal job is stuck in pending state and that blocks the cleanup of Azure IoT Operations.
247294

248-
To work around this issue, you need to manually delete the CRD and finish the uninstall. To do this, complete the following steps:
295+
To work around this issue, complete the following steps to manually delete the CRD and finish the uninstall:
249296

250297
1. Delete the AssetType CRD manually: `kubectl delete crd assettypes.opcuabroker.iotoperations.azure.com --ignore-not-found=true`
251298

@@ -406,4 +453,4 @@ Log signature: N/A
406453

407454
---
408455

409-
Data flows marks message retries and reconnects as errors, and as a result data flows may look unhealthy. This behavior is only seen in previous versions of data flows. Review the logs to determine if the data flow is healthy.
456+
Data flows marks message retries and reconnects as errors, and as a result data flows might look unhealthy. This behavior is only seen in previous versions of data flows. Review the logs to determine if the data flow is healthy.

0 commit comments

Comments
 (0)