Exportação de logs do IoT Platform - IoT Platform: Central de Documentação do Alibaba Cloud

Pré-requisitos

O Simple Log Service deve estar ativado. Para mais informações, consulte Get started with Simple Log Service.

Observações de uso

O IoT Platform não permite exportar ou baixar arquivos de log diretamente. Para obter, exportar ou fazer backup dos logs do IoT Platform, ative o recurso de exportação de logs. Isso envia os logs em tempo real para um Logstore no Simple Log Service, permitindo consulta, análise e armazenamento de longo prazo.

Apenas contas Alibaba Cloud têm acesso ao recurso de exportação de logs.

A exportação de logs para um Logstore no Simple Log Service gera custos. Para mais informações, consulte Billing of Simple Log Service.

Ativar a exportação de logs do IoT Platform

Ative o recurso de exportação de logs individualmente para cada product.

Faça login no console do IoT Platform.
Na página Overview, localize a instância que deseja gerenciar e clique em ID ou no nome da instância.
No painel de navegação à esquerda, escolha O&M > Log Service.
Selecione um product e clique em aba Export IoT Platform Logs.
Clique em Enable Now.
Na caixa de diálogo exibida, siga as instruções para ativar a exportação de logs.

Nota
Se o Simple Log Service não estiver ativado, clicar em

Enable Now

redireciona você para a página de ativação do service.
1. Clique em Create ao lado de Role e Log Export Destination.
  
  Nota
  Se
  
  Created
  
  aparecer ao lado de
  
  Role
  
  e
  
  Log Export Destination
  
  , ignore esta etapa.
2. Clique em OK.
Ao ativar a exportação de logs para um product, o sistema cria automaticamente um local de armazenamento de logs e uma função vinculada ao service para exportação.
- Função vinculada ao service para exportação de logs: concede as permissões necessárias para a exportação. Para mais informações, consulte Role description.
- Local de armazenamento de logs:
  - Project:iot-log-${uid}-${regionId}. Neste nome,${uid}é o ID da sua conta Alibaba Cloud e ${regionId}é a região onde seu service IoT Platform está hospedado.
  - Logstore:iot-logs.
  Todos os seus products compartilham este local de armazenamento. A palavra-chave ProductKey no conteúdo do log distingue os diferentes products. Para mais informações sobre logs, consulte IoT Platform logs.
Defina o período de retenção de dados.

Os logs exportados são excluídos após o término do período de retenção especificado. O período padrão é de 7 dias. Defina a retenção entre 1 e 3000 dias ou escolha a retenção permanente.

Na aba Export IoT Platform Logs, clique em Set Data Retention Period. Você será redirecionado para a página de gerenciamento do Logstore. Em seguida, clique em Modify, defina o Data Retention Period e clique em Save.

Uso do recurso de consulta e análise de logs

Após ativar a exportação de logs do IoT Platform, execute as operações abaixo na aba Export IoT Platform Logs:

Na aba Raw Logs:

Operação	Descrição
Consultar e analisar logs	Na aba Raw Logs, utilize instruções SQL para consultar logs dentro de um intervalo de tempo específico e realizar análises estatísticas. Para mais informações sobre a sintaxe SQL, consulte Query syntax and features e Analysis syntax.
Statistical Charts	Visualize os gráficos estatísticos gerados na aba Statistical Charts.
LogReduce	Utilize a aba LogReduce para agregar logs com alta similaridade e obter rapidamente uma visão geral dos seus logs.
Field Settings	Analise rapidamente a distribuição de um campo específico nos resultados após consultar os logs.
Configure Alerts	Receba informações de alerta via SMS, chamadas de voz, e-mail e robôs do DingTalk quando um alerta for acionado.

Na aba Log Reports:

Operação Descrição

Visualizar relatórios

Visualize relatórios de log para um intervalo de tempo especificado. Esses relatórios mostram o status operacional e problemas anômalos dos dispositivos. Para uma lista dos itens incluídos, consulte a Tabela 1. Descrições dos relatórios.

Por padrão, os relatórios exibem dados da última hora, com granularidade de tempo de 1 minuto para gráficos de linhas.

Para definir o intervalo de tempo, clique em lista suspensa azul de configuração de tempo no canto superior direito da página ou clique em > Select Time Range no canto superior direito de um relatório individual.
Na aba Raw Logs, use SQL para definir a granularidade de tempo dos gráficos de linhas. Para mais informações sobre a sintaxe, consulte Date and time functions.
Por exemplo, use bizCode:device | SELECT date_format(date_trunc('hour',__time__), '%m-%d %H:%i') AS Time, count(1) AS count , operation GROUP BY Time, operation ORDER BY Time limit 1440 para definir a granularidade de tempo como 1 hora.

Subscribe to Reports O sistema renderiza periodicamente os relatórios como imagens e os envia para pessoas especificadas por e-mail ou através de robôs do DingTalk.

Tabela 1. Descrições dos relatórios
Relatório	Estilo de exibição	Descrição
Contagem de dispositivos online/offline	Gráfico de linhas	Exibe o número de vezes que os dispositivos ficaram online e offline dentro de um intervalo de tempo especificado.
Número de mensagens originadas/terminadas em dispositivo móvel	Gráfico de linhas	Mostra a quantidade de mensagens originadas e terminadas em dispositivo móvel dentro de um intervalo de tempo especificado.
Top 20 dispositivos por volume de mensagens originadas/terminadas em dispositivo móvel	Lista	Apresenta os 20 dispositivos com maior volume de mensagens originadas ou terminadas em dispositivo móvel, juntamente com os respectivos volumes.
Distribuição de códigos de erro de script de análise de dados	Gráfico de pizza	Indica a distribuição de códigos de erro ocorridos durante a análise de scripts dentro de um intervalo de tempo especificado. Consulte os logs por código de erro para ver detalhes dos erros de análise de scripts e otimize seus scripts adequadamente.
Top 10 dispositivos com erros de script de análise de dados	Lista	Relaciona os 10 dispositivos com mais erros de análise de scripts dentro de um intervalo de tempo especificado e suas respectivas contagens de erros. Pesquise os logs pelo DeviceName do dispositivo para ver detalhes dos erros de análise de scripts e otimize seus scripts adequadamente.
Distribuição de códigos de erro de validação de modelo TSL (Thing Specification Language)	Gráfico de pizza	Mostra a distribuição de códigos de erro de validação de modelo TSL dentro de um intervalo de tempo especificado. Filtre os logs por código de erro para visualizar detalhes dos erros de validação de modelo TSL e solucionar os problemas.
Top 10 dispositivos com erros de validação de modelo TSL	Lista	Exibe os 10 dispositivos com mais erros de validação de modelo TSL dentro de um intervalo de tempo especificado e suas respectivas contagens de erros. Utilize o DeviceName do dispositivo para consultar logs, ver detalhes dos erros de validação de modelo TSL e solucionar os problemas.
Volume de mensagens de assinatura server-side	Gráfico de linhas	Apresenta o volume de mensagens encaminhadas através de assinaturas server-side AMQP e MNS dentro de um intervalo de tempo especificado.
Últimos 20 registros anômalos de mensagens de dispositivos	Gráfico de pizza	Exibe os últimos 20 registros anômalos de mensagens de dispositivos dentro de um intervalo de tempo especificado. Busque os logs pelo DeviceName do dispositivo e código de erro para ver detalhes das mensagens anômalas e solucionar os problemas.
Número de mensagens de encaminhamento de dados	Gráfico de linhas	Mostra o volume de mensagens encaminhadas para outros services cloud dentro de um intervalo de tempo especificado.
Últimos 20 registros anômalos de encaminhamento do mecanismo de regras	Lista	Apresenta os últimos 20 registros anômalos de encaminhamento do mecanismo de regras dentro de um intervalo de tempo especificado. Consulte os logs pelo DeviceName do dispositivo e código de erro para ver detalhes do encaminhamento anômalo do mecanismo de regras e solucionar os problemas.
Distribuição de erros de chamada de API cloud	Gráfico de pizza	Indica a distribuição de erros de chamada de API cloud dentro de um intervalo de tempo especificado. Pesquise os logs pelo nome da API e utilize os detalhes do log e códigos de erro para solucionar os problemas.

Desativar a exportação de logs do IoT Platform

Desative o recurso de exportação de logs para um product específico a qualquer momento para economizar espaço de armazenamento.

No console do IoT Platform, acesse a página Instance Overview e clique em cartão da instância desejada.
No painel de navegação à esquerda, escolha O&M > Log Service.
Selecione um product e clique em aba Export IoT Platform Logs.
Clique em Disable Export e, em seguida, clique em Confirm.

Após desativar a exportação de logs para o product, novos logs do IoT Platform deixam de ser exportados para o Logstore. Os logs já exportados permanecem armazenados até o fim do período de retenção definido e depois são excluídos.