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á.
# Solucionar 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.
**Topics**
+ [Configurar AWS IoT Core registros](#configure-iot-logs)
+ [Configurar uma ação de erro na republicação](#configure-republish-error-action)
+ [Solucionar problemas em regras](#troubleshoot-rule-issues)
+ [Solucionar problemas em uma regra (AWS IoT SiteWise)](#rule-tutorial-troubleshoot-rule)
+ [Solucionar problemas em uma regra (DynamoDB)](#dynamodb-tutorial-troubleshoot-rule)
## Configurar AWS IoT Core registros
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](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) no *Guia do AWS IoT desenvolvedor*.
1. Navegue até o [console do CloudWatch ](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, escolha **Grupos de logs**.
1. Escolha o grupo **AWSIotRegistros**.
1. Escolha um fluxo de log recente. Por padrão, CloudWatch exibe primeiro o fluxo de registros mais recente.
1. 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”.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png)
1. Compare as mensagens de erro com os erros deste tópico a fim de solucionar o problema.
## Configurar uma ação de erro na 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 ](#configure-iot-logs) os registros.
**Como adicionar uma ação de erro de republicação a uma regra**
1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/).
1. No painel de navegação esquerdo, escolha **Agir** e **Regras**.
1. Selecione a regra.
1. Em **Error action (Ação de erro)**, escolha **Add action (Adicionar ação)**.
1. 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.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png)
1. Escolha **Configurar ação** na parte inferior da página.
1. 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.
1. Escolha **Selecionar** para conceder AWS IoT Core acesso para executar a ação de erro.
1. Selecione **Select (Escolher)** ao lado da função criada para a regra.
1. Escolha **Update Role (Atualizar função)** para adicionar outras permissões à função.
1. 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.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png)
1. 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](https://console.aws.amazon.com/iot/).
1. Na página de navegação à esquerda, selecione **Test (Testar)** para abrir o cliente de teste MQTT.
1. 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.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png)
1. 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.
## Solucionar problemas em regras
Use as informações a seguir para solucionar problemas de regra.
**Topics**
+ [Erro: o membro deve estar entre 604.800 segundos antes e 300 segundos depois do time stamp atual.](#rule-error-timestamp-out-of-range)
+ [Erro: o valor da propriedade não corresponde ao tipo de dados ](#rule-error-invalid-data-type)
+ [Erro: Usuário: não está autorizado a executar: iotsitewise: no recurso BatchPutAssetPropertyValue](#rule-error-role-not-authorized)
+ [Erro: iot.amazonaws.com não consegue executar: sts: no recurso: AssumeRole ](#rule-error-unable-to-assume-role)
+ [Informação: Nenhuma solicitação foi enviada. PutAssetPropertyValueEntries estava vazio após a execução dos modelos de substituição.](#rule-info-request-was-empty)
### 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
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: 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:
+ Verifique se o alias da propriedade está correto e se você tem uma propriedade de ativo com o alias de propriedade fornecido. Para obter mais informações, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md).
+ Verifique se a regra tem uma função e se a função tem a concede a permissão `iotsitewise:BatchPutAssetPropertyValue` à propriedade de ativo do destino, como por toda a hierarquia do ativo de destino. Para obter mais informações, consulte [AWS IoT Conceda o acesso necessário](grant-rule-access.md).
### Erro: iot.amazonaws.com não consegue executar: sts: no recurso: AssumeRole
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](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html) 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](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html) no *Guia do desenvolvedor* do AWS IoT .
## Solucionar problemas em uma regra (AWS IoT SiteWise)
Siga as etapas deste procedimento para solucionar problemas de sua regra se os dados de uso da CPU e da memória não estiverem aparecendo AWS IoT SiteWise conforme o esperado. 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. Você também pode configurar o registro no CloudWatch Logs para solucionar problemas. Para obter mais informações, consulte [Solucionar problemas de uma ação de AWS IoT SiteWise regra](#troubleshoot-rule).
**Como adicionar uma ação de erro de republicação a uma regra**
1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/).
1. No painel de navegação à esquerda, escolha **Roteamento de mensagens** e **Regras**.
1. Escolha a regra que criou anteriormente e escolha **Edit**.
1. Em **Ação de erro -* opcional***, escolha **Adicionar ação de erro**.
1. Escolha **Republicar uma mensagem em um AWS IoT tópico**.
1. Em **Tópico**, insira o caminho para o erro (por exemplo,**sitewise/rule/tutorial/error**). AWS IoT Core republicará as mensagens de erro neste tópico.
1. Escolha a função que você criou anteriormente (por exemplo, **SiteWiseTutorialDeviceRuleRole**).
1. Selecione **Atualizar**.
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.
**Como se inscrever no tópico de ação de erro**
1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/).
1. Na página de navegação à esquerda, selecione **MQTT test client** para abrir o cliente de teste MQTT.
1. Em **Filtro de tópicos**, insira **sitewise/rule/tutorial/error** e, em seguida, escolha **Criar assinatura**.
Quando forem exibidas mensagens de erro, visualize a matriz `failures` em qualquer mensagem de erro para diagnosticar problemas. Para obter mais informações sobre possíveis problemas e como resolvê-los, consulte [Solucionar problemas de uma ação de AWS IoT SiteWise regra](#troubleshoot-rule).
Se os erros não aparecerem, verifique se a regra está habilitada e se você se inscreveu no mesmo tópico que configurou na ação de erro de republicação. Se os erros ainda não aparecerem depois que você fizer isso, verifique se o script do dispositivo está sendo executado e se está atualizando a sombra do dispositivo com êxito.
**nota**
Você também pode se inscrever no tópico de atualização paralela do seu dispositivo para ver a carga útil que sua AWS IoT SiteWise ação analisa. Para fazer isso, assine o tópico a seguir.
```
$aws/things/+/shadow/update/accepted
```
## Solucionar problemas em uma regra (DynamoDB)
Siga as etapas neste procedimento para solucionar problemas de sua regra se os dados do ativo de demonstração não estiverem aparecendo na tabela do DynamoDB conforme o esperado. 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. Você também pode configurar o registro no CloudWatch Logs para solucionar problemas. Para obter mais informações, consulte [Monitoramento com CloudWatch registros](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) no *Guia do AWS IoT desenvolvedor*.
**Como adicionar uma ação de erro de republicação a uma regra**
1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/).
1. No painel de navegação esquerdo, escolha **Agir** e **Regras**.
1. Escolha a regra que criou anteriormente.
![\[AWS IoT Captura de tela principal da página “Regras”.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png)
1. Em **Error action (Ação de erro)**, escolha **Add action (Adicionar ação)**.
1. Escolha **Republicar uma mensagem em um AWS IoT tópico**.
![\[AWS IoT Captura de tela principal da página “Selecionar uma ação” com a ação Republicar destacada.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png)
1. Escolha **Configurar ação** na parte inferior da página.
1. Em **Tópico**, insira **windspeed/error**. AWS IoT O Core republicará as mensagens de erro neste tópico.
![\[AWS IoT Captura de tela principal da página “Configurar ação de republicação” com o “Tópico” destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png)
1. Escolha **Selecionar** para conceder acesso ao AWS IoT Core para executar a ação de erro usando a função que você criou anteriormente.
1. Escolha **Select (Selecionar)** ao lado da função.
![\[AWS IoT Captura de tela principal da página “Configurar ação de republicação” com o botão de seleção de função destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png)
1. Escolha **Update Role (Atualizar função)** para adicionar outras permissões à função.
![\[AWS IoT Captura de tela principal da página “Configurar ação de republicação” com o botão de atualização da função destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png)
1. Escolha **Add action (Adicionar ação)** para concluir a adição da ação de erro.
1. Escolha a seta para trás no canto superior esquerdo do console para retornar à página inicial do console AWS IoT Core.
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.
**Como se inscrever no tópico de ação de erro**
1. Na página de navegação à esquerda do console AWS IoT principal, escolha **Testar**.
1. No campo **Subscription topic (Tópico de assinatura)**, insira **windspeed/error** e selecione **Subscribe to topic (Assinar o tópico)**.
![\[AWS IoT Captura de tela principal da página “Cliente MQTT” com o botão “Inscrever-se no tópico” destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png)
1. Observe a exibição de mensagens de erro e explore a matriz `failures` em uma mensagem de erro para diagnosticar os seguintes problemas comuns:
+ Erros de digitação na instrução de consulta de regra
+ Permissões de função insuficientes
Se os erros não aparecerem, verifique se a regra está habilitada e se você se inscreveu no mesmo tópico que configurou na ação de erro de republicação. Se os erros ainda não aparecerem, verifique se os ativos de parque eólico de demonstração ainda existem e se você ativou notificações nas propriedades da velocidade do vento. Se seus ativos de demonstração expiraram e desapareceram AWS IoT SiteWise, você pode criar uma nova demonstração e atualizar a declaração de consulta de regras para refletir o modelo e a propriedade IDs atualizados do ativo.