Solução de problemas de uma ação de AWS IoT SiteWise regra - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de uma ação de AWS IoT SiteWise regra

Para solucionar problemas de sua ação de AWS IoT SiteWise regra em AWS IoT Core, você pode executar um dos seguintes procedimentos:

  • Configurar Amazon CloudWatch Logs

  • Configure uma ação de erro de republicação para a regra

Depois, compare as mensagens de erro com os erros deste tópico a fim de solucionar o problema.

Configurando registros AWS IoT Core

Você pode configurar AWS IoT para registrar vários níveis de informações no CloudWatch Logs.

Para configurar e acessar CloudWatch registros
  1. Para configurar o registro em log AWS IoT Core, consulte Monitoramento com CloudWatch registros no Guia do AWS IoT desenvolvedor.

  2. Navegue até o console do CloudWatch .

  3. No painel de navegação, escolha Grupos de logs.

  4. Escolha o AWSIotLogsgrupo.

  5. Escolha um fluxo de log recente. Por padrão, CloudWatch exibe primeiro o fluxo de registros mais recente.

  6. Escolha uma entrada de log para expandir a mensagem de log. A entrada de log para se parecer com a captura de tela a seguir.

    
      CloudWatch Captura de tela de “AWS IoT Registros”.
  7. Compare as mensagens de erro com os erros deste tópico a fim de solucionar o problema.

Configurar uma ação de erro de republicação

É possível configurar uma ação de erro na regra para processar mensagens de erro. Neste procedimento, configure a ação de regra de republicação como uma ação de erro para exibir mensagens de erro no cliente de teste MQTT.

nota

A ação de erro de republicação gera somente o equivalente de logs de nível ERROR. Se você quiser registros mais detalhados, deverá configurar CloudWatch os registros.

Como adicionar uma ação de erro de republicação a uma regra
  1. Navegue até o console do AWS IoT.

  2. No painel de navegação esquerdo, escolha Agir e Regras.

  3. Selecione a regra.

  4. Em Error action (Ação de erro), escolha Add action (Adicionar ação).

  5. Escolha Republicar uma mensagem em um AWS IoT tópico.

    
      AWS IoT Core Captura de tela da página “Selecionar uma ação” com a ação Republicar destacada.
  6. Escolha Configurar ação na parte inferior da página.

  7. Em Tópico, insira um tópico exclusivo (por exemplo,sitewise/windfarm/rule/error). AWS IoT Core republicará as mensagens de erro neste tópico.

  8. Escolha Selecionar para conceder AWS IoT Core acesso para executar a ação de erro.

  9. Selecione Select (Escolher) ao lado da função criada para a regra.

  10. Escolha Update Role (Atualizar função) para adicionar outras permissões à função.

  11. Selecione Adicionar ação.

    A ação de erro da regra deve ser semelhante à captura de tela a seguir.

    
      AWS IoT Core Página “Regra” Republique a captura de tela da ação de erro.
  12. Escolha a seta para trás no canto superior esquerdo do console para retornar à página inicial do AWS IoT console.

Depois de configurar a ação de erro de republicação, você pode visualizar as mensagens de erro no cliente de teste MQTT no AWS IoT Core.

No procedimento a seguir, você se inscreve no tópico de erro no cliente de teste MQTT. No cliente de teste MQTT, é possível receber as mensagens de erro da regra para solucionar o problema.

Como se inscrever no tópico de ação de erro
  1. Navegue até o console do AWS IoT.

  2. Na página de navegação à esquerda, selecione Test (Testar) para abrir o cliente de teste MQTT.

  3. No campo Subscription topic (Tópico de assinatura), insira o tópico de erro configurado anteriormente (por exemplo, sitewise/windfarm/rule/error) e selecione Subscribe to topic (Assinar o tópico).

    
      AWS IoT Core Captura de tela da página “Cliente MQTT” com o botão “Inscrever-se no tópico” destacado.
  4. Aguarde até que as mensagens de erro sejam exibidas e expanda a matriz failures em qualquer mensagem de erro.

    Depois, compare as mensagens de erro com os erros deste tópico a fim de solucionar o problema.

Solução de problemas

Use as informações a seguir para solucionar problemas de regra.

Erro: o membro deve estar entre 604.800 segundos antes e 300 segundos depois do time stamp atual.

Seu time stamp tem mais de 7 minutos ou menos de 5 minutos, comparado ao horário Unix epoch atual. Faça o seguinte:

  • Verifique e o time stamp está no horário Unix epoch (UTC). Se fornecer um time stamp com um fuso horário diferente, você receberá esse erro.

  • Verifique se seu carimbo de data/hora está em segundos. AWS IoT SiteWise espera que os carimbos de data/hora sejam divididos em segundos (na época do Unix) e compensados em nanossegundos.

  • Verifique se você está fazendo upload de dados com time stamp de até 7 dias antes.

Erro: o valor da propriedade não corresponde ao tipo de dados <type>

Uma entrada na ação de regra tem um tipo de dados diferente da propriedade de ativo do destino. Por exemplo, a propriedade de ativo do destino é um DOUBLE e o tipo de dados que você selecionou é Integer (Inteiro) ou o valor foi transmitido em integerValue. Faça o seguinte:

  • Se você configurar a regra no AWS IoT console, verifique se escolheu o tipo de dados correto para cada entrada.

  • Se você configurar a regra a partir da API ou AWS Command Line Interface (AWS CLI), verifique se seu value objeto usa o campo de tipo correto (por exemplo, doubleValue para uma DOUBLE propriedade).

Erro: Usuário: <role-arn>não está autorizado a executar: iotsitewise: no recurso BatchPutAssetPropertyValue

A regra não está autorizada a acessar a propriedade de ativo do destino, ou a propriedade de ativo do destino não existe. Faça o seguinte:

Erro: iot.amazonaws.com não consegue executar: sts: no recurso: AssumeRole <role-arn>

Seu usuário não está autorizado a assumir a função em sua regra no AWS Identity and Access Management (IAM).

Verifique se o seu usuário tem a permissão do iam:PassRole para a função em sua regra. Para obter mais informações, consulte Pass role permissions no Guia do desenvolvedor do AWS IoT .

Informação: nenhuma solicitação foi enviada. PutAssetPropertyValueEntries estava vazio após a execução dos modelos de substituição.

nota

Essa mensagem é um log de nível INFO.

A solicitação deve ter pelo menos uma entrada com todos os parâmetros necessários.

Verifique se os parâmetros da regra, incluindo os modelos de substituição, resultam em valores não vazios. Os modelos de substituição não podem acessar valores definidos nas cláusulas AS na instrução de consulta da regra. Para obter mais informações, consulte Modelos de substituição no Guia do desenvolvedor do AWS IoT .