Monitore com Amazon CloudWatch Logs

Configure AWS IoT SiteWise para registrar informações no CloudWatch Logs para monitorar e solucionar problemas do serviço.

Quando você usa o AWS IoT SiteWise console, AWS IoT SiteWise cria uma função vinculada ao serviço que permite que o serviço registre informações em seu nome. Se você não usa o AWS IoT SiteWise console, deve criar manualmente uma função vinculada ao serviço para receber registros. Para obter mais informações, consulte Crie uma função vinculada a serviço para o AWS IoT SiteWise.

Você deve ter uma política de recursos que permita AWS IoT SiteWise colocar eventos de log em CloudWatch fluxos. Para criar e atualizar uma política de recursos para o CloudWatch Logs, execute o comando a seguir. Substituir logging-policy-name com o nome da política a ser criada.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch O Logs também oferece suporte às chaves de contexto de SourceAccount condição aws: SourceArn e aws:. Essas chaves de contexto de condição são opcionais.

Para criar ou atualizar uma política de recursos que AWS IoT SiteWise permita colocar somente registros associados ao AWS IoT SiteWise recurso especificado em CloudWatch fluxos, execute o comando e faça o seguinte:

• Substituir logging-policy-name com o nome da política a ser criada.

• Substituir source-ARN com o ARN do seu AWS IoT SiteWise recurso, como um modelo de ativo ou ativo. Para encontrar o ARN para cada tipo de AWS IoT SiteWise recurso, consulte Tipos de recursos definidos por AWS IoT SiteWise na Referência de Autorização de Serviço.

• Substituir account-ID com o ID da AWS conta associado ao AWS IoT SiteWise recurso especificado.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

Por padrão, AWS IoT SiteWise não registra informações no CloudWatch Logs. Para ativar o registro, escolha um nível de registro diferente de Desativado (OFF). AWS IoT SiteWise suporta os seguintes níveis de registro:

• OFF: o registro em log está desativado.

• ERROR: os erros são registrados em log.

• INFO: os erros e mensagens informativas são registrados em log.

Você pode configurar os gateways do SiteWise Edge para registrar informações no CloudWatch Logs por meio AWS IoT Greengrass de. Para obter mais informações, consulte Monitore os registros do gateway SiteWise Edge.

Você também pode configurar AWS IoT Core para registrar informações no CloudWatch Logs se estiver solucionando uma ação de AWS IoT SiteWise regra. Para obter mais informações, consulte Solucionar problemas de uma ação de AWS IoT SiteWise regra.

Sumário

• Gerenciar o login AWS IoT SiteWise
  • Encontre seu nível de registro
  • Alterar seu nível de registro
• Exemplo: entradas do arquivo de AWS IoT SiteWise log

Gerenciar o login AWS IoT SiteWise

Use o AWS IoT SiteWise console ou AWS CLI para as seguintes tarefas de configuração de registro.

Encontre seu nível de registro

Console

Use o procedimento a seguir para encontrar o nível de registro em log atual no console do AWS IoT SiteWise .

Para encontrar seu nível de AWS IoT SiteWise registro atual

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação à esquerda, escolha Opções de registro em log.

   O status do registro em log atual aparece em Status do registro em log. Se o registro em log estiver habilitado, o nível de registro em log atual será exibido em Nível de verbosidade.

AWS CLI

Execute o comando a seguir para encontrar seu nível de AWS IoT SiteWise registro atual com AWS CLI o.

aws iotsitewise describe-logging-options

A operação retorna uma resposta que contém o nível do registro em log no seguinte formato.

{
  "loggingOptions": {
    "level": "String"
  }
}

Alterar seu nível de registro

Use o procedimento a seguir para alterar seu nível de registro no AWS IoT SiteWise console ou usando AWS CLI.

Console

Para alterar seu nível de AWS IoT SiteWise registro

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação à esquerda, escolha Opções de registro em log.

3. Selecione a opção Editar.

4. Escolha o Nível de verbosidade a ser habilitado.

5. Escolha Salvar.

AWS CLI

Execute o AWS CLI comando a seguir para alterar seu nível de AWS IoT SiteWise registro. Substituir logging-level com o nível de registro que você deseja.

aws iotsitewise put-logging-options --logging-options level=logging-level

Exemplo: entradas do arquivo de AWS IoT SiteWise log

Cada entrada de AWS IoT SiteWise registro inclui informações do evento e recursos relevantes para esse evento, para que você possa entender e analisar os dados do registro.

O exemplo a seguir mostra uma entrada de CloudWatch AWS IoT SiteWise registros que registra quando você cria com sucesso um modelo de ativo.

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}