Todos os produtos
Search
Central de documentação

IoT Platform:Logs locais do dispositivo

Última atualização: Jul 02, 2026

Dispositivos, incluindo gateways e subdispositivos, podem enviar logs para a nuvem. Consulte os logs locais do dispositivo na página Simple Log Service no console IoT Platform para solucionar problemas.

Pré-requisitos

  • O dispositivo foi desenvolvido com o Android SDK ou C SDK e está configurado para enviar logs. Para mais informações, consulte Enviar logs do dispositivo.

  • Caso o dispositivo possua uma chave de envio de logs implementada via SDK, acesse Device Management > Devices. Localize o dispositivo e clique em View. Na página Device Details, ative a chave Report On-premises Device Logs. Esta etapa não é necessária se o dispositivo não tiver uma chave de envio de logs.

Consultar logs locais do dispositivo

  1. Faça login no console IoT Platform.

  2. Na página Overview, localize a instância que deseja gerenciar e clique no ID ou no nome da instância.

  3. No painel de navegação à esquerda, clique em Monitoring & O&M > Simple Log Service.

  4. Selecione um produto e clique na aba On-premises Device Logs.

  5. Insira os critérios de busca e clique no ícone de pesquisa.

    A tabela a seguir descreve os critérios de busca disponíveis.

    Critério de busca

    Descrição

    DeviceName

    Insira o nome de um dispositivo para buscar logs relacionados a ele.

    TraceId

    Insira um ID de rastreamento para buscar logs em módulos vinculados.

    Palavra-chave do nome do módulo

    Insira o nome de um módulo para buscar logs gerados por ele.

    Palavra-chave do conteúdo

    Insira uma palavra-chave presente no conteúdo do log. As palavras-chave suportadas incluem parâmetros de requisição de API, motivos de erro, ID da mensagem (MessageID), ID do cliente (clientId) e operação (Operation).

    Intervalo de tempo

    Selecione o período em que os logs foram enviados.

Campos do log

Cada entrada de log contém os seguintes campos.

Parâmetro Descrição
Hora do envio Momento em que o dispositivo enviou o log.
Hora da coleta Momento em que o dispositivo coletou o log.
TraceId ID de rastreamento, utilizado para buscar logs em módulos vinculados.
DeviceName Nome do dispositivo.
Nível do log Por padrão, logs de todos os níveis são exibidos. É possível filtrar os logs por nível. Os níveis estão listados em ordem decrescente de severidade, exceto OTHER:
  • FATAL
  • ERROR
  • WARN
  • INFO
  • DEBUG
  • OTHER: Outros níveis de log.
Nome do módulo Nome do módulo que gerou o log.
  • Para dispositivos que utilizam o Android SDK, o nome do módulo é ALK-LK.
  • Para dispositivos que utilizam o C SDK, o nome do módulo é personalizado.
Conteúdo Conteúdo detalhado do log.

Análise de logs do dispositivo

Cada entrada de log inclui um código de status de resultado especificado pelo parâmetro Code. Utilize esse código de status para analisar os logs.

O código de erro pode ser gerado pelo SDK do lado do dispositivo (Códigos de erro do Android SDK e Códigos de erro do C SDK) ou ser um código de status personalizado.