MonitoramentoAWS IoT SiteWise com Amazon CloudWatch Logs - AWS IoT SiteWise
Gerenciar o registro em log do AWS IoT SiteWise (console)Gerenciar o registro em log do AWS IoT SiteWise (CLI)Exemplo: Entradas de arquivo de log do 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á.

MonitoramentoAWS IoT SiteWise com Amazon CloudWatch Logs

Você podeAWS IoT SiteWise configurar o registro de informações CloudWatch nos registros para monitorar e solucionar problemas do serviço.

Quando você usa o console do AWS IoT SiteWise, o AWS IoT SiteWise cria uma função vinculada ao serviço que permite que o serviço registre em log informações em seu nome. Se você não usar o console do AWS IoT SiteWise, crie manualmente uma função vinculada ao serviço para receber registos. Para obter mais informações, consulte Criar uma função vinculada ao serviço para o AWS IoT SiteWise.

É necessário ter uma política de recurso permitindoAWS IoT SiteWise colocar eventos de log em CloudWatch streams. Para criar e atualizar uma política de recurso do 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 aws:SourceArn e aws:SourceAccount condition. Essas chaves de contexto de condição são opcionais.

Para criar ou atualizar uma política de recursos que permitaAWS IoT SiteWise colocar somente registros associados aoAWS 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 ARN de origem pelo ARN do seuAWS IoT SiteWise recurso, como um modelo de ativo ou ativo. Para encontrar o ARN para cada tipo deAWS IoT SiteWise recurso, consulte Tipos de recursos definidos porAWS IoT SiteWise na Referência de Autorização de Serviço.

  • Substitua a ID daAWS conta pela ID da conta associada aoAWS 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 nos CloudWatch registros. Para ativar o registro, escolha um nível de registro diferente de Desativado (OFF). AWS IoT SiteWisesuporta os seguintes níveis de registro:

  • OFF— O registro em log está desativado.

  • ERROR— Os erros são registrados.

  • INFO— Erros e mensagens informativas são registrados.

Você pode configurar gateways para registrar informações CloudWatch nos registrosAWS IoT Greengrass. Para obter mais informações, consulte Monitorar logs de gateway.

Você também pode configurarAWS IoT Core para registrar informações CloudWatch nos registros se estiver solucionando problemas em uma ação deAWS IoT SiteWise regra. Para obter mais informações, consulte Solucionar problemas de uma ação de regra do AWS IoT SiteWise.

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

Você pode usar o console do AWS IoT SiteWise para as seguintes tarefas de configuração do registro em 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.

Como encontrar o nível do registro em log do AWS IoT SiteWise atual

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

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

    O status do registro em log atual aparece em Logging (Status do registro em log). Se o registro estiver ativado, o nível de registro atual aparecerá em Nível de verbosidade.

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

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

Como alterar o nível de registro em log do AWS IoT SiteWise

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

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

  3. Escolha Edit (Editar).

  4. Escolha o nível de verbosidade a ser ativado.

  5. Escolha Save (Salvar).

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

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

Encontrar o nível de registro em log (CLI)

Execute o seguinte comando para localizar o nível de registro em log do AWS IoT SiteWise atual com a AWS CLI.

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 seguinte comando da AWS CLI para alterar o nível do registro em log do AWS IoT SiteWise. 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 de arquivo de log do AWS IoT SiteWise

Cada entrada deAWS 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 êxito 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"
  }
}