Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo lista os problemas atualmente conhecidos que pode encontrar ao utilizar o Operações IoT do Azure. As orientações ajudam-no a identificar estes problemas e fornecem soluções alternativas, quando disponíveis.
Para orientações gerais de resolução de problemas, veja Troubleshoot Operações IoT do Azure.
Problemas do broker MQTT
Esta seção lista os problemas conhecidos atuais para o broker MQTT.
Os recursos do MQTT broker não são visíveis no portal do Azure
ID do problema: 4257
Assinatura de log: N/A
Os recursos do MQTT broker criados no teu cluster usando Kubernetes não são visíveis no portal Azure. Este resultado é esperado porque gerir componentes do Operações IoT do Azure usando Kubernetes é apenas para depuração e testes, e a sincronização de recursos da Edge para a cloud atualmente não é suportada.
Atualmente, não existe solução para este problema.
Problemas gerais do conector
Esta seção lista os problemas conhecidos atuais que afetam todos os conectores.
Nomes maiúsculos de endpoints de entrada impedem a sincronização da saúde do dispositivo
ID do problema: 0202
Aplica-se a: Operações IoT do Azure 2610 pré-visualização pública, reportado na v1.6.0-preview.57 com o conector para ONVIF.
Correção planeada para a versão 2612.
Assinatura de registo: No portal Azure Activity Log, Microsoft.DeviceRegistry/namespaces/devices/write falha com InvalidRequestContent:
The request body contains a duplicate JSON key '<endpoint name in lowercase>'. Each property name may appear at most once.
Podes criar um dispositivo com um nome de endpoint de entrada que contenha letras maiúsculas, mas as escritas de estado subsequentes falham. O estado de configuração usa um nome de endpoint em minúsculas, enquanto o estado em tempo de execução preserva a capitalização original. O Azure rejeita as chaves duplicadas resultantes.
A experiência operacional pode indicar que o dispositivo foi criado e sincronizado, enquanto o seu estado de saúde permanece desconhecido. O estado de funcionamento real do endpoint e os erros de conectividade não são visíveis no Azure.
Solução alternativa: Use letras minúsculas, dígitos e hífens nos nomes dos endpoints de entrada. Para um dispositivo afetado existente, guarde a sua configuração, identifique ativos e cargas de trabalho dependentes, e planeie a interrupção antes de apagar e recriar o dispositivo com um nome de endpoint minúsculo. Verifica se as escritas de estado são bem-sucedidas e que a saúde é reportada após o jogo.
O Connector não deteta atualizações das credenciais dos dispositivos no Azure Key Vault
ID do problema: 6514
N/A
Corrigido na versão 2605 e posteriores
O conector não recebe notificação quando as credenciais do dispositivo armazenadas no Azure Key Vault são atualizadas. Como resultado, o conector continua a usar as credenciais antigas até ser reiniciado.
Solução alternativa: Reinicie o conector para o forçar a recuperar as credenciais atualizadas do Azure Key Vault.
Conector para problemas do OPC UA
Esta seção lista os problemas conhecidos atuais do conector para OPC UA.
Não é possível usar caracteres especiais em nomes de eventos
ID do problema: 1532
Corrigido na versão 1.3.36 (2603) e posteriores
Assinatura de log: 2025-10-22T14:51:59.338Z aio-opc-opc.tcp-1-68ff6d4c59-nj2s4 - Updated schema information for Boiler#1Notifier skipped!
A geração de esquema falhará se os nomes de eventos contiverem caracteres especiais, como #, %ou &. Evite usar esses caracteres em nomes de eventos para evitar problemas de geração de esquema.
Falta-se o modelo do conector OPC
ID da emissão: 1330
Corrigido na versão 1.4.73 (2608) e posteriores
Assinatura de log: N/A
A implementação da instância de Operações IoT do Azure deve instalar um OPC ConnectorTemplate por predefinição. Após a implementação, o modelo do conector falta no portal do Azure e o ConnectorTemplate recurso não está presente no cluster.
Conector para mídia e conector para questões ONVIF
Esta seção lista os problemas conhecidos atuais para o conector para mídia e o conector para ONVIF.
ContinuousMove indica sucesso sem mover uma câmara
ID do problema: 0205
Aplica-se a: A experiência de operações de pré-produção utilizada com a pré-visualização pública do Operações IoT do Azure. O impacto na experiência das operações de produção ainda não foi confirmado.
Correção planeada para a versão 2612.
Assinatura de log: A PTZ>ContinuousMove ação retorna Succeeded com um resultado vazio:
{"Result": {}}
O formulário de execução requer o Zoom>X , embora Velocity.Zoom seja opcional no esquema de pedido da ação. Numa câmara pan-tilt afetada sem zoom ótico, submeter o formulário apresenta sucesso, mas a câmara não se move.
Solução alternativa: Invocar a ação do PTZ>ContinuousMove ativo através do Azure Resource Manager executeAction com um payload que inclua PanTilt mas omita .Zoom Por exemplo, use o seguinte corpo de pedido, substituindo <media-profile-token> por um token devolvido pela ação da Media>GetProfiles câmara:
{
"managementGroupName": "PTZ",
"managementActionName": "ContinuousMove",
"payload": {
"ContinuousMove": {
"ProfileToken": "<media-profile-token>",
"Velocity": {
"PanTilt": {
"x": 0.3,
"y": 0
}
},
"Timeout": "PT1S"
}
}
}
Enviar payload como objeto JSON, não como uma string codificada em JSON. Use valores de movimento suportados pela sua câmara e verifique o resultado com PTZ>GetStatus; um resultado vazio e bem-sucedido por si só não confirma o movimento.
A descoberta de multimédia excede o limite do endpoint de dispositivos detetados
ID do problema: 5382
Aplica-se a: pré-visualização pública do Operações IoT do Azure 2610, reportado na v1.6.0-preview.57 com conector para ONVIF v1.6.5.
Correção planeada para a versão 2612.
Assinatura de log: No portal Azure, no Activity Log, Microsoft.DeviceRegistry/namespaces/discoveredDevices/write falha com InvalidRequestContent, com MaxProperties a direcionar properties.endpoints.inbound:
The object must not contain more than 10 properties.
O conector para ONVIF gera endpoints de media para múltiplos transportes por perfil de media. O Azure Device Registry rejeita dispositivos descobertos que excedam 10 endpoints de entrada. Uma câmara com três perfis de media pode exceder este limite.
O endpoint ONVIF da câmara pode reportar Disponível e o ativo ONVIF descoberto pode aparecer, mas o dispositivo descoberto que contém os endpoints de media não aparece no Azure. Não é possível importar esses pontos finais para configurar o conector multimédia por deteção.
Solução alternativa: Crie manualmente um dispositivo com um ponto final de entrada Microsoft.Media, utilizando o URL do fluxo RTSP da câmara indicado na documentação do fabricante, como rtsp://<camera-ip>:554/<stream-path>. Configura as credenciais através das referências secretas suportadas, depois cria o ativo multimédia e os fluxos de snapshot ou clips de que precisares. Veja Configurar o conector para multimédia.
Conflito de sincronização secreto
ID do problema: 0606
Assinatura de log: N/A
Ao usar a sincronização secreta, certifique-se de que os nomes secretos sejam globalmente exclusivos. Se existir um segredo local com o mesmo nome, os conectores podem não conseguir recuperar o segredo pretendido.
Conector para problemas com MQTT
Incompatibilidade da versão do modelo do conector MQTT durante a atualização
ID da emissão: 1533
Assinatura de log: N/A
Corrigido na versão 2606 e posteriores
Ao atualizar para a versão 2605, os modelos existentes dos conectores MQTT podem mostrar versões de metadados desalinhadas no portal. Para resolver, elimine e recrie o modelo de conector. Alternativamente, use a CLI do Azure para atualizar o conector.
O conector MQTT não consegue ligar-se a brokers MQTT externos que tenham endereços IP privados
ID da emissão: 7791
Assinatura de log: N/A
Corrigido na versão 2607 e posteriores
A partir da versão 2605, o conector MQTT não consegue ligar-se a corretores MQTT externos que usam endereços IP privados.
Problemas de fluxos de dados
Esta seção lista os problemas conhecidos atuais para fluxos de dados.
A atualização falha devido a uma incompatibilidade da audience do endpoint do registo ACR
ID do problema: 3245
Assinatura de log: N/A
Uma atualização do Operações IoT do Azure pode falhar e reverter se um grafo de fluxo de dados usar um endpoint do registo Azure Container Registry (ACR) com um público ou âmbito do Azure Resource Manager (ARM) explicitamente configurado. Exemplos anteriores de documentação usavam a audience ARM, pelo que uma configuração existente que funcionava antes da atualização pode ser afetada.
O operador Dataflows regista um erro de desajuste de audiência semelhante a:
audience 'https://management.azure.com/' does not match the expected audience 'https://containerregistry.azure.net'
Solução alternativa: Atualize o recurso Azure do endpoint existente do registo através do Azure Resource Manager antes de tentar novamente a atualização:
- Para autenticação de identidade gerida atribuída ao sistema, altere
properties.authentication.systemAssignedManagedIdentitySettings.audiencedehttps://management.azure.com/parahttps://containerregistry.azure.net. - Para autenticação de identidade gerida atribuída pelo utilizador, altere
properties.authentication.userAssignedManagedIdentitySettings.scopedehttps://management.azure.com/.defaultparahttps://containerregistry.azure.net/.default.
Mantenha as outras propriedades do endpoint do registo e as definições de autenticação. Atualize o recurso existente em vez de apenas alterar um ficheiro local de implementação ou omitir um argumento de um comando update. Depois de o recurso Azure e a sua configuração correspondente do cluster refletirem o novo valor, tente novamente a atualização.
Para exemplos de configuração de endpoints de registo, veja Configurar endpoints de registo.
A interface Web do Operations Experience apresenta apenas artefactos de gráfico de fluxo de dados obtidos do Azure Container Registry (ACR) e de mcr.microsoft.com
ID da emissão: 8895
Assinatura de log: N/A
Mesmo que configures um endpoint de registo de contentores para um registo de contentores que não seja ACR, como o GHCR:
Os artefactos de gráfico de fluxo de dados do registo não ACR não aparecem na interface Web da experiência de operações, pelo que não é possível criar um gráfico de fluxo de dados que os utilize.
Selecionar um grafo de fluxo de dados da lista de fluxos de dados na interface web de experiência de operações que contenha elementos de um registo não-ACR produz um erro semelhante a:
Can't load data flow graph. The contents of this data flow graph are unavailable. Please ensure that it still exists, then work with your administrator to get 'AcrPull' access to required registry endpoints.
Solução alternativa: Tens duas opções:
Se não precisares de usar a interface de experiência operacional, usa a CLI do Azure para realizar operações CRUD em grafos de fluxo de dados definidos em ficheiros JSON ou Bicep que contenham artefactos provenientes de registos não ACR.
Se pretender utilizar a interface Web de operações, importe artefactos e grafos de fluxo de dados de registos que não sejam ACR para um registo ACR. Para saber mais, consulte Publicar módulos no seu registo.
Os recursos de fluxo de dados criados com Kubernetes não são visíveis na interface web da experiência operacional
ID do problema: 8724
Assinatura de log: N/A
Os recursos personalizados de fluxo de dados criados no seu cluster usando o Kubernetes não são visíveis na interface web da experiência operacional. Este resultado é esperado porque gerir componentes do Operações IoT do Azure usando Kubernetes é apenas para depuração e testes, e a sincronização de recursos da Edge para a cloud atualmente não é suportada.
Atualmente, não existe solução para este problema.
Não é possível usar a mesma definição de gráfico várias vezes em um cenário de gráfico encadeado
ID da emissão: 1352
Corrigido na versão 1.3.36 (2603) e posteriores
Falha ao enviar config
Você cria um cenário de gráfico encadeado usando a saída de um gráfico de fluxo de dados como entrada para outro gráfico de fluxo de dados. No entanto, se você tentar usar a mesma definição de gráfico várias vezes nesse cenário, ele atualmente não funciona como esperado. Por exemplo, o código a seguir falha ao usar a mesma definição de grafo (graph-passthrough:1.3.6) tanto para graph-1 quanto para graph-2.
{
nodeType: 'Graph'
name: 'graph-1'
graphSettings: {
registryEndpointRef: dataflowRegistryEndpoint.name
artifact: 'graph-passthrough:1.3.6'
configuration: []
}
}
{
nodeType: 'Graph'
name: 'graph-2'
graphSettings: {
registryEndpointRef: dataflowRegistryEndpoint.name
artifact: 'graph-passthrough:1.3.6'
configuration: graphConfiguration
}
}
nodeConnections: [
{
from: {name: 'source'}
to: {name: 'graph-1'}
}
{
from: {name: 'graph-1'}
to: {name: 'graph-2'}
}
{
from: {name: 'graph-2'}
to: {name: 'destination'}
}
]
Para resolver esse erro, envie a definição do gráfico para o ACR quantas vezes forem necessárias com o cenário com um nome ou tag diferente a cada vez. Por exemplo, no cenário descrito, a definição do gráfico precisa ser empurrada duas vezes com um nome diferente ou uma tag diferente, como graph-passthrough-one:1.3.6 e graph-passthrough-two:1.3.6.
Problemas com o registo de bordas
Esta secção lista os problemas atualmente conhecidos para o registo edge.
A configuração de identidade atribuída pelo utilizador utiliza a conta de serviço de registo errada
ID do problema: 3467
Aplica-se a: Operações IoT do Azure 2610 public preview. Reportado na v1.6.0-preview.57; a incompatibilidade da CLI também existe na extensão da CLI v2.11.2, cujo perfil de implementação em pré-visualização usa v1.6.0-preview.60.
Correção planeada para a versão 2612.
Assinatura de log: N/A
Quando executa az iot ops identity assign --usage schema numa instância de pré-visualização afetada, a CLI cria uma credencial federada com o sujeito system:serviceaccount:azure-iot-operations:adr-schema-registry. O registo de pré-visualização na borda é executado com a conta de serviço aio-edge-registry, por isso a credencial não corresponde à carga de trabalho.
O comando pode indicar sucesso, mesmo que a conta de serviço do registo de borda não tenha uma credencial federada correspondente. O registo pode continuar a usar a identidade atribuída ao sistema existente, mascarando a incompatibilidade de configuração.
Solução:
- Na identidade gerida atribuída pelo utilizador destinada ao registo da borda, adicione uma credencial federada com estes valores:
- Emissor: A URL do emissor OIDC do cluster conectado.
-
Assunto:
system:serviceaccount:azure-iot-operations:aio-edge-registrypara o espaço de nomes padrão. Se usares outro namespace, substitui o namespace efetivo. -
Público:
api://AzureADTokenExchange.
- Verifique se a credencial corresponde à conta de serviço usada pelo pod do registo da borda. Se precisares de reiniciar o registo de pré-visualização, o seu StatefulSet é
aio-edge-registry, nãoadr-schema-registry.
Adicionar esta credencial corrige a incompatibilidade da confiança, mas a adoção de uma alteração de identidade pelo registo em funcionamento está separadamente sob investigação. Adicionar a credencial não confirma que o registry mudou de identidade. A seleção entre múltiplas identidades atribuídas pelo utilizador também está a ser investigada.
Problemas com ações de gestão
Esta secção lista problemas conhecidos atuais das ações de gestão.
A subscrição do Event Grid não está pronta imediatamente após as ações de gestão serem ativadas
ID do problema: 0208
Aplica-se a: extensão CLI v2.11.0 na pré-visualização pública do Operações IoT do Azure 2610, com ocorrência comunicada na v1.6.0-preview.57.
Correção planeada para a versão 2612.
Assinatura de registo: O pod de fluxo de dados regista falhas de subscrição, e a métrica Mqtt.FailedSubscriptionOperations de namespace Event Grid reporta Error=AuthorizationError.
O az iot ops mgmt-actions enable comando cria o grafo de fluxo de dados do pedido antes de atribuir os papéis de Publisher e Subscriber do Event Grid TopicSpaces. O gráfico pode tentar subscrever antes de ser autorizado. Tenta novamente com recuo, e falhas de autorização podem continuar brevemente após o CLI reportar sucesso.
As ações de gestão podem não atingir a borda até que a subscrição do grafo de pedidos seja bem-sucedida.
Solução alternativa: Espere cerca de um minuto após az iot ops mgmt-actions enable retornar antes de enviar a primeira ação. Verifique os registos do grafo de pedidos para confirmar que a subscrição é bem-sucedida. Se as falhas de autorização continuarem, verifique as atribuições de funções necessárias e permita tempo extra para a propagação das funções atribuídas. Não repita automaticamente ações não idempotentes cujo resultado de execução é desconhecido.
Questões de identidade federada
Esta secção lista questões conhecidas atuais para identidade federada.
A incompatibilidade entre emissores de credenciais de identidade federadas pode causar falhas na autenticação de sincronização secreta
ID da emissão: 1190
Corrigido na versão 2607 e posteriores
Assinatura de log: Semelhante a AADSTS700211: No matching federated identity record found for presented assertion issuer 'https://northamerica.oic.prod-arc.azure.com/1f5f7baf-633d-4eb5-9be1-8cf1e9c6fcc9/f512e8f6-0c47-48a1-91f3-aeb5422dd766'. Please check your federated identity credential Subject, Audience and Issuer against the presented assertion.
O Operações IoT do Azure depara-se com erros 401 Unauthorized ao obter segredos do Azure Key Vault.
Causa raiz: O erro ocorre porque a URL do emissor da credencial de identidade federada não corresponde à reivindicação do emissor (iss) no token da conta do serviço Kubernetes.
Quando o comando az iot ops secretsync enable cria uma credencial de identidade federada (FIC) na identidade gerida atribuída a utilizador que o Operações IoT do Azure utiliza para aceder ao Azure Key Vault, define o URL do emissor da FIC para o URL do emissor OIDC do cluster. Em algumas implementações, este URL inclui uma barra final ('/') que o campo iss (emissor) do token da conta de serviço emitido pelo cluster omite.
Como o problema afeta a troca de tokens durante a recuperação de segredos, a falha normalmente não ocorre quando executa az iot ops secretsync enable. Em vez disso, surge mais tarde, quando o Operações IoT do Azure tenta aceder a um segredo, o que pode dificultar a identificação da causa raiz.
Solução alternativa: Verifique se o URL do emissor configurado na credencial de identidade federada não termina com uma barra. Se acontecer, atualize a credencial de identidade federada para remover a barra final.
Pode utilizar os comandos da CLI do Azure az identity federated-credential para ver e, se necessário, atualizar o valor do emissor da credencial de identidade federada, por exemplo:
az identity federated-credential show --name <fic-name> --identity-name <managed-identity-name> --resource-group <resource-group-name>
az identity federated-credential update --name <fic-name> --identity-name <managed-identity-name> --resource-group <resource-group> --issuer <new-issuer-url-without-trailing-slash>
Como boa prática, realize esta validação durante a configuração após executar o az iot ops secretsync enable comando para ajudar a evitar falhas de autenticação potencialmente difíceis de diagnosticar mais tarde.
Problemas com o Protocolo de Contexto do Modelo (MCP)
Esta secção lista os problemas atuais conhecidos do MCP.
A implementação com certificados geridos pelo cliente falha quando o MCP está ativado
ID do problema: 3314
Aplica-se a: Operações IoT do Azure 2610 public preview.
Correção planeada para a versão 2612.
Assinatura de log: N/A
Quando utiliza o seu próprio emissor de certificados, a implementação do Operações IoT do Azure falha se o MCP estiver ativado. Os componentes MCP referenciam o emissor de certificados predefinido e o trust bundle em vez dos seus recursos configurados.
Solução alternativa: Para avaliar outras funcionalidades do Operações IoT do Azure com certificados geridos pelo cliente, defina explicitamente features.mcp.mode como Disabled na sua configuração de implementação antes da implementação. O MCP está ativado por defeito. Veja Desativar MCP para a definição de configuração.