IotHub
  1. Docs TALQ
IotHub
  • API
    • TALQ
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Create a Talq Device
        • List Talq Devices
        • Modify a Talq Device
        • Update Talq Devices
        • Delete a Talq Device
        • Get a Talq Device
        • Modify a Talq Device patch
        • Update a Talq Device
        • Get a Talq Device Function
        • Get a Talq Device Attribute
      • Group
        • List Talq Groups
        • Get a Talq Group
      • Create a Talq Service
  • Docs TALQ
    • Visão Geral do Projeto
    • Processo de Inicialização - Bootstrap Process
    • API TALQ
    • API GUIA
    • Tratamento de Erros
    • Configurações da instância
    • Agendamentos
    • Configuração de logger
    • Gerenciamento de grupos
    • Alertas, Configurações de Alertas e Medições
  1. Docs TALQ

Configuração de logger

Configuração de Logger IoT#

Configurar corretamente o modo de registro é essencial para garantir que o Gateway colete as informações certas no momento certo. Essa definição permite controlar como e quando os dados serão registrados, de acordo com o que foi definido no sistema central (CMS). Com isso, é possível manter um monitoramento eficiente, evitar falhas na coleta e garantir que só os dados realmente importantes sejam enviados e armazenados.

Acessando a Página de Configurações#

A primeira coisa que devemos fazer é acessar a página “Configurações de Logger IoT”.
image.png Imagem: acessando a página

Visão Geral da Página#

Na página principal, é possível observar:
1.
Filtros de configuração de registro
2.
Filtros de configuração de envio
3.
Tabela com todas as configurações já criadas, incluindo algumas informações detalhadas
image.pngImagem: visão geral da página

Criando uma Nova Configuração#

Para criar uma nova configuração, clique no botão “Adicionar Configurações”.
image.png Imagem: posição do botão

Campos da Nova Configuração#

Ao iniciar uma nova configuração, os seguintes campos estão disponíveis:
1.
Nome – Define como essa configuração será chamada.
2.
Referência – Campo opcional para observações ou descrições (texto livre).
3.
Fornecedor do dispositivo gateway e o dispositivo específico que será usado.
4.
Etapas para realizar a configuração do logger.
image.pngImagem: visão geral da página
Para acessar as etapas do item 4, é necessário preencher os campos 1 e 3.

Etapa 1 – Dispositivos Alvo#

Com os campos obrigatórios preenchidos, o Passo 1 libera o campo:
“Adicionar lista de:”
Aqui você escolhe se e quais dispositivos ou grupos serão afetados ou não afetados pela nova configuração.
image.png
Imagem: opções do Passo 1

Etapa 2 – Tipo de Envio#

Você deverá escolher o tipo de envio da configuração:

Agendado#

Permite definir horários fixos para envio dos registros.
É possível adicionar um tempo aleatório (random delay).
Exemplo: horário fixo = 12:00h, tempo aleatóio = 360s → envio entre 12:00h e 12:06h.
Define também a quantidade de tentativas possíveis.
image.png Imagem: Opções do modo agendado

Imediato#

Permite definir um delay de envio.
Se for zero, o envio é imediato.
Se for maior que zero, o dispositivo acumula as mudanças e envia todas de uma vez ao final do período.
image.png Imagem: opção Imediato

Etapa 3 – Configuração de Registro#

Nesta etapa, você define como os logs serão enviados:
Modo definido pelo fornecedor
Modo periódico
Modo baseado em evento
image.png Imagem: 3 opções

Modos que Adicionam Novos Passos#

Modo Definido pelo Fornecedor#

Sem necessidade de configuração adicional.
Utiliza o comportamento padrão do dispositivo.

Modo Periódico#

Necessário fazer uma curta configuração:
1.
Período de Coleta
Pode ser apenas uma data/hora inicial, ou
Um intervalo com data/hora inicial e final
2.
Amostragem
Define o tempo entre cada coleta de dados
Exemplo: a cada 10 minutos, a cada 1 hora etc.
Se nenhuma amostragem for definida, será coletada apenas uma única amostra, que ocorrerá:
Na hora inicial especificada, ou
Imediatamente, caso o horário inicial já tenha passado e o final ainda não tenha sido alcançado
image.png Imagem: Modo periódico
Adicionam dois novos passos:

Etapa 4 – Conteúdo do Registro#

Seleção de atributos (opcional):
Escopo: Configuration, Measurement, Event, Operational
Origem: Função específica ou Tipo de Função
Atributo IoT + Porcentagem de variação para acionar o registro
Exemplo: Se o valor inicial é 100 e a % for 25, o registro será feito quando ultrapassar 125.
É possível adicionar mais de um atributo com diferentes origens.
Na imagem abaixo realizei a escolha da origem como Tipo de Função e escolhi parametros que são originados dela
image.png Imagem: seleção de atributos

Etapa 5 – Período de Registro#

Define em que período do dia a gravação estará ativa.
Se não for especificado, ela ficará ativa o dia todo.

Modos disponíveis:#

Absoluto: Horário fixo (início/fim)
Amanhecer / Pôr do Sol: Usa eventos naturais do dia
Sensor: Depende de gatilhos de sensores
Combinado: Combinação entre sensor e eventos do dia
Por Valor: Baseado em valores de atributos
image.png Imagem: período de registro

Modo Baseado em Evento#

Este modo adiciona apenas mais um passo: Período de Execução.
Aqui você define uma lista de inclusão ou exclusão de eventos para ativar os registros.
image.png
image.png Imagem: configuração de evento
Após todas as configurações estarem completas, basta clicar em Salvar para registrar a nova configuração.
Modified at 2025-06-09 18:27:18
Previous
Agendamentos
Next
Gerenciamento de grupos