Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo lista os problemas conhecidos atuais que você pode encontrar ao usar Operações do Azure IoT. As diretrizes ajudam você a identificar esses problemas e fornece soluções alternativas quando disponíveis.
Para obter diretrizes gerais de solução de problemas, consulte Troubleshoot Operações do Azure IoT.
Problemas com o corretor MQTT
Esta seção lista os problemas conhecidos atuais para o agente MQTT.
Os recursos do agente MQTT não estão visíveis no portal do Azure
ID do problema: 4257
Assinatura de log: N/A
Os recursos do agente MQTT criados em seu cluster usando o Kubernetes não estão visíveis no portal Azure. Esse resultado é esperado porque managem de componentes Operações do Azure IoT usando o Kubernetes é apenas para depuração e teste, e não há suporte para sincronizar recursos da borda para a nuvem no momento.
Atualmente, não há nenhuma solução alternativa para esse 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 do Azure IoT 2610, prévia pública, relatado na versão v1.6.0-preview.57 com o conector para ONVIF.
Correção planejada para o lançamento 2612.
Assinatura de log: No portal de Atividade do Azure, 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.
Você pode criar um dispositivo com um nome de endpoint de entrada que contenha letras maiúsculas, mas as gravações de status do dispositivo subsequentes falham. O status de configuração usa um nome de endpoint minúsculo, enquanto o status em tempo de execução preserva a capitalização original. O Azure rejeita as chaves duplicadas resultantes.
A experiência operacional pode informar que o dispositivo foi criado e sincronizado enquanto sua integridade permanece Unknown. Os erros reais de saúde e conectividade do endpoint 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, salve sua configuração, identifique ativos e cargas de trabalho dependentes, e planeje a interrupção antes de excluir e recriar o dispositivo com um nome de endpoint minúsculo. Verifique se as gravações de status são bem feitas e que a integridade é informada após a recriação.
O conector não detecta atualizações nas credenciais do dispositivo no Azure Key Vault
ID do problema: 6514
N/A
Corrigido na versão 2605 e posterior
O conector não recebe uma notificação quando as credenciais do dispositivo armazenadas em Azure Key Vault são atualizadas. Como resultado, o conector continua a usar as credenciais antigas até que seja reiniciado.
Solução alternativa: reinicie o conector para forçá-lo a recuperar as credenciais atualizadas do Azure Key Vault.
Problemas do conector para 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 posterior
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 do modelo de conector OPC
ID da edição: 1330
Corrigido na versão 1.4.73 (2608) e posteriores
Assinatura de log: N/A
A implantação da instância do Operações do Azure IoT deve instalar um OPC ConnectorTemplate por padrão. Após a implantação, o template de conector está ausente no portal do Azure e o ConnectorTemplate recurso não está presente no cluster.
Conector para mídia e conector para problemas de ONVIF
Esta seção lista os problemas conhecidos atuais para o conector para mídia e o conector para ONVIF.
O ContinuousMove relata sucesso sem mover uma câmera
ID do problema: 0205
Aplica-se a: A experiência de operações de pré-produção usada com o Operações do Azure IoT public preview. O impacto na experiência das operações de produção ainda não foi confirmado.
Correção planejada para o lançamento 2612.
Assinatura de log: A PTZ>ContinuousMove ação retorna Succeeded com um resultado vazio:
{"Result": {}}
O formulário de execução exige o Zoom>X , mesmo sendo Velocity.Zoom opcional no esquema de solicitação da ação. Em uma câmera pan-tilt afetada sem zoom óptico, enviar o formulário reporta sucesso, mas a câmera 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 omite Zoom. Por exemplo, use o seguinte corpo de requisição, substituindo <media-profile-token> por um token devolvido pela ação da Media>GetProfiles câmera:
{
"managementGroupName": "PTZ",
"managementActionName": "ContinuousMove",
"payload": {
"ContinuousMove": {
"ProfileToken": "<media-profile-token>",
"Velocity": {
"PanTilt": {
"x": 0.3,
"y": 0
}
},
"Timeout": "PT1S"
}
}
}
Envie payload como um objeto JSON, não como uma string codificada em JSON. Use valores de movimento suportados pela sua câmera e verifique o resultado com PTZ>GetStatus; um resultado vazio e bem-sucedido sozinho não confirma o movimento.
A descoberta de mídia excede o limite de endpoint de dispositivos descobertos
ID do problema: 5382
Aplica-se a: Operações do Azure IoT 2610 prévia pública, reportado na v1.6.0-preview.57 com conector para ONVIF v1.6.5.
Correção planejada para o lançamento 2612.
Assinatura de log: No Log de Atividades do Azure, Microsoft.DeviceRegistry/namespaces/discoveredDevices/write falha com InvalidRequestContent, com MaxProperties direcionado a properties.endpoints.inbound:
The object must not contain more than 10 properties.
O conector para ONVIF gera endpoints de mídia para múltiplos transportes por perfil de mídia. O Azure Device Registry rejeita dispositivos descobertos que excedam 10 endpoints de entrada. Uma câmera com três perfis de mídia pode exceder esse limite.
O endpoint ONVIF da câmera pode reportar Disponível e seu ativo descoberto ONVIF pode aparecer, mas o dispositivo descoberto contendo seus endpoints de mídia não aparece no Azure. Você não pode importar esses endpoints para configurar o conector de mídia pelo Discovery.
Solução alternativa: Crie um dispositivo manualmente com um Microsoft.Media endpoint de entrada usando a URL do fluxo RTSP da câmera da documentação do fabricante, como rtsp://<camera-ip>:554/<stream-path>. Configure as credenciais por meio das referências secretas suportadas, depois crie o recurso de mídia e os fluxos de snapshot ou clipes que você precisa. Veja Configurar o conector para mídia.
Conflito de sincronização de segredo
ID do problema: 0606
Assinatura de log: N/A
Ao usar a sincronização secreta, verifique se os nomes de segredo são globalmente exclusivos. Se existir um segredo local com o mesmo nome, os conectores poderão não recuperar o segredo pretendido.
Conector para problemas de MQTT
Incompatibilidade de versão do modelo do conector MQTT durante a atualização
ID do problema: 1533
Assinatura de log: N/A
Corrigido na versão 2606 e posteriores
Ao atualizar para a versão 2605, os modelos de conector MQTT existentes podem exibir versões de metadados incompatíveis no portal. Para resolver, exclua e recrie o modelo de conector. Como alternativa, use o CLI do Azure para atualizar o conector.
O conector MQTT não pode se conectar a agentes MQTT externos que têm endereços IP privados
ID do problema: 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 se conectar 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.
Falha na atualização devido a uma incompatibilidade de público-alvo do ponto de extremidade do registro do ACR
ID do problema: 3245
Assinatura de log: N/A
Uma atualização do Operações do Azure IoT pode falhar e reverter se um grafo de fluxo de dados usar um endpoint do Registro de Contêiner do Azure (ACR) com uma audiência ou escopo do Azure Resource Manager (ARM) explicitamente configurado. Exemplos anteriores de documentação usavam o público ARM, então uma configuração existente que funcionava antes da atualização pode ser afetada.
O operador Dataflows registra um erro de descorrespondência 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 do registro existente via Azure Resource Manager antes de tentar novamente a atualização:
- Para autenticação de identidade gerenciada atribuída ao sistema, mude
properties.authentication.systemAssignedManagedIdentitySettings.audiencedehttps://management.azure.com/parahttps://containerregistry.azure.net. - Para autenticação de identidade gerenciada atribuída pelo usuário, mude
properties.authentication.userAssignedManagedIdentitySettings.scopedehttps://management.azure.com/.defaultparahttps://containerregistry.azure.net/.default.
Mantenha as propriedades dos outros endpoints de registro e as configurações de autenticação. Atualize o recurso existente em vez de apenas alterar um arquivo de implantação local ou omitir um argumento de um comando update. Depois que o recurso do Azure e sua configuração correspondente do cluster refletirem o novo valor, tente novamente a atualização.
Para exemplos de configuração de endpoints de registry, veja Configurar endpoints de registry.
Interface do usuário da Web da experiência de operações apenas exibe artefatos de grafos de fluxo de dados provenientes do Registro de Contêiner do Azure (ACR) e mcr.microsoft.com.
ID da emissão: 8895
Assinatura de log: N/A
Mesmo que você configure um ponto de extremidade de registro de contêineres para um registro de contêineres que não seja ACR, como o GHCR:
Artefatos de grafo de fluxo de dados de um registro que não seja ACR não aparecem na interface web de operações, portanto você não pode criar um grafo de fluxo de dados que use esses artefatos.
Selecionar um grafo de fluxo de dados da lista de fluxos de dados na interface web da experiência operacional que contenha elementos de um registro 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: Você tem duas opções:
Se você não precisa usar a interface de experiência operacional, use a CLI do Azure para realizar operações CRUD em grafos de fluxo de dados definidos em arquivos JSON ou Bicep que contenham artefatos provenientes de registros não ACR.
Se quiser usar a interface web da experiência de operações, importe artefatos e grafos de fluxo de dados de registros não-ACR para um registro ACR. Para saber mais, veja Enviar módulos ao seu registro.
Recursos de fluxo de dados criados usando 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 ficam visíveis na interface do usuário da Web da experiência de operações. Esse resultado é esperado porque managem de componentes Operações do Azure IoT usando o Kubernetes é apenas para depuração e teste, e não há suporte para sincronizar recursos da borda para a nuvem no momento.
Atualmente, não há nenhuma solução alternativa para esse problema.
Não é possível usar a mesma definição de grafo várias vezes em um cenário de grafo encadeado
ID do problema: 1352
Corrigido na versão 1.3.36 (2603) e posterior
Falha ao enviar a configuração
Você cria um cenário de grafo encadeado usando a saída de um grafo de fluxo de dados como a entrada para outro grafo de fluxo de dados. No entanto, se você tentar usar a mesma definição de grafo várias vezes nesse cenário, ela atualmente não funcionará conforme o esperado. Por exemplo, o código a seguir falha ao usar a mesma definição de grafo (graph-passthrough:1.3.6) para ambos graph-1 e 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 grafo para o ACR quantas vezes forem necessárias, atribuindo um nome ou tag diferente ao cenário a cada vez. Por exemplo, no cenário descrito, a definição do grafo precisa ser transferida 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 do Edge registry
Esta seção lista os problemas atuais conhecidos para o registro de borda.
A configuração de identidade atribuída pelo usuário usa a conta de serviço de registro errada
ID do problema: 3467
Aplica-se a: prévia pública do Operações do Azure IoT 2610. 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 implantação de prévia usa v1.6.0-preview.60.
Correção planejada para o lançamento 2612.
Assinatura de log: N/A
Quando você executa az iot ops identity assign --usage schema em uma 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 registro de borda de pré-visualização roda como conta aio-edge-registryde serviço, então a credencial não corresponde à carga de trabalho.
O comando pode reportar sucesso mesmo que a conta de serviço do registro de borda não tenha credencial federada correspondente. O registro pode continuar usando sua identidade atribuída ao sistema existente, mascarando a incompatibilidade de configuração.
Solução alternativa:
- Na identidade gerenciada atribuída pelo usuário destinada ao registro de 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 namespace padrão. Se você usar outro namespace, substitua pelo namespace específico em uso. -
Público:
api://AzureADTokenExchange.
- Verifique se a credencial corresponde à conta de serviço usada pelo pod de registro de borda. Se você precisar reiniciar o registro de pré-visualização, seu StatefulSet é
aio-edge-registry, nãoadr-schema-registry.
Adicionar essa credencial corrige a incompatibilidade da confiança, mas a adoção de uma mudança de identidade pelo registro em execução está sob investigação separada. Adicionar a credencial não confirma que o registry mudou de identidade. A seleção entre múltiplas identidades atribuídas pelo usuário também está sob investigação.
Problemas com ações de gerenciamento
Esta seção lista problemas conhecidos atuais para ações de gerenciamento.
A assinatura 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 no Operações do Azure IoT 2610 prévia pública, reportada na v1.6.0-preview.57.
Correção planejada para o lançamento 2612.
Assinatura de log: O pod de fluxo de dados registra falhas de assinatura, e a métrica Mqtt.FailedSubscriptionOperations de namespace Event Grid reporta Error=AuthorizationError.
O comando az iot ops mgmt-actions enable cria o grafo de fluxo de dados da solicitação antes de atribuir as funções Event Grid TopicSpaces Publisher e Subscriber. O gráfico pode tentar se inscrever antes de ser autorizado. Ele tenta novamente com recuo, e falhas de autorização podem continuar brevemente após o CLI reportar sucesso.
Ações gerenciais podem não alcançar a borda até que a assinatura do grafo de requisição tenha sucesso.
Solução alternativa: Espere cerca de um minuto após o retorno de az iot ops mgmt-actions enable antes de enviar a primeira ação. Verifique os registros do grafo de solicitação para confirmar que a assinatura é bem-sucedida. Se as falhas de autorização continuarem, verifique as atribuições de função necessárias e permita tempo extra para a propagação da função. Não reproduza automaticamente ações não idempotentes cujo resultado de execução é desconhecido.
Questões de identidade federada
Esta seçã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 ediçã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.
As Operações do Azure IoT encontram erros não autorizados 401 ao recuperar segredos do Azure Key Vault.
Causa raiz: O erro ocorre porque a URL federada do emissor de credencial de identidade não corresponde à reivindicação do emissor (iss) no token da conta de serviço Kubernetes.
Quando o az iot ops secretsync enable comando cria uma credencial de identidade federada (FIC) na identidade gerenciada atribuída pelo usuário que o Operações do Azure IoT usa para acessar o Azure Key Vault, ele define a URL do emissor FIC para a URL do emissor OIDC do cluster. Em algumas implantações, essa URL inclui uma barra no final ('/'), que é omitida na declaração iss (issuer) do token de conta de serviço emitido pelo cluster.
Como o problema afeta a troca de tokens durante a recuperação secreta, a falha normalmente não ocorre quando você executa az iot ops secretsync enable. Em vez disso, isso só se manifesta mais tarde, quando o Operações do Azure IoT tenta acessar um segredo, o que pode dificultar a identificação da causa raiz.
Solução alternativa: Verifique se a URL do emissor configurada na credencial federada de identidade não termina com barra. Se ela existir, atualize a credencial de identidade federada para remover a barra final.
Você pode usar os comandos az identity federated-credential da CLI do Azure para exibir 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 essa 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 posteriormente.
Problemas com o Protocolo de Contexto do Modelo (MCP)
Esta seção lista os problemas atuais conhecidos do MCP.
A implantação com certificados gerenciados pelo cliente falha quando o MCP está habilitado
ID do problema: 3314
Aplica-se a: prévia pública do Operações do Azure IoT 2610.
Correção planejada para o lançamento 2612.
Assinatura de log: N/A
Quando você traz seu próprio emissor de certificados, a implantação do Operações do Azure IoT falha se o MCP estiver ativado. Os componentes MCP referenciam o emissor de certificado padrão e o pacote de confiança em vez dos recursos configurados.
Solução alternativa: Para avaliar outros recursos do Operações do Azure IoT com certificados gerenciados pelo cliente, defina explicitamente features.mcp.mode como Disabled na sua configuração de implantação antes de implantar. O MCP está ativado por padrão.
Veja Desativar o MCP para a definição de configuração.