Monitoramento AWS IoT SiteWise com Amazon CloudWatch Logs - AWS IoT SiteWise
Gerenciar o registro em log do AWS IoT SiteWise (console)Gerenciando o login AWS IoT SiteWise (CLI)Exemplo: entradas do arquivo de AWS IoT SiteWise log

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á.

Monitoramento AWS IoT SiteWise com Amazon CloudWatch Logs

Você pode configurar 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 ter mais informações, consulte Crie uma função vinculada ao 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. logging-policy-nameSubstitua pelo 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:

  • logging-policy-nameSubstitua pelo nome da política a ser criada.

  • Substitua o Source-ARN pelo 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.

  • Substitua a ID da AWS conta pela ID da conta associada ao recurso especificado AWS IoT SiteWise .

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 ter mais informações, consulte Monitorando registros SiteWise do gateway 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 ter mais informações, consulte Solução de problemas de uma ação de AWS IoT SiteWise regra.

Gerenciar o registro em log do AWS IoT SiteWise (console)

Você pode usar o AWS IoT SiteWise console para as seguintes tarefas de configuração de log.

Encontrar o nível de registro em log (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.

Alterar o nível do registro em log (console)

Use o procedimento a seguir para alterar seu nível de registro no AWS IoT SiteWise 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.

Gerenciando o login AWS IoT SiteWise (CLI)

Você pode usar o AWS Command Line Interface (AWS CLI) para as seguintes tarefas de configuração de registro.

Encontrar o nível de registro em log (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 o nível de registro em log (CLI)

Execute o AWS CLI comando a seguir para alterar seu nível de AWS IoT SiteWise registro. Substitua nível de registro pelo nível de registro em log desejado.

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"
  }
}