Datalogs

As configurações de gravação de um modelo: uma amostra por intervalo, os canais que ela captura, e a ordem das colunas que toda execução segue.

Ver como Markdown

Um datalog é uma configuração de gravação reutilizável do modelo. Ele declara o que uma execução anota: uma amostra por intervalo, carregando todo canal que o datalog lista, cada valor emparelhado com a qualidade em que foi lido (Good ou Unavailable). Ele não declara nada sobre como o modelo se desenha: um gráfico é um componente de um dashboard, não uma configuração daqui. Os datalogs vivem em Process > Modelos > modelo > Preparação > Datalogs e exigem a permissão Editar receitas e avaliações.

Um modelo guarda quantos datalogs precisar. Um procedimento aponta para um pelo estágio Registrar dele, e é essa referência que faz uma execução gravar: um procedimento sem datalog não grava amostra nenhuma e não pode carregar avaliação, porque uma avaliação julga sobre linhas gravadas. Os comandos Snapshot e Avaliar agora de um painel também gravam por um datalog, uma linha por vez.

A pasta Datalogs

Selecionar a linha Datalogs abre a página da pasta ("Configurações de gravação reaproveitáveis: um intervalo periódico de snapshot e os canais capturados em toda execução que referencia uma delas.") com um cartão por datalog, por nome; clicar num cartão o abre, e o X o remove. Sem nenhum, a página diz "Nenhum datalog ainda. Adicione um."

Comando	O que faz	Fica cinza quando (situação)	Não é desenhado quando (papel)
Datalog (barra de detalhe, com a pasta selecionada; clique direito Adicionar datalog)	Acrescenta `Novo datalog <n>` a 1000 ms, sem colunas. A linha entra no grupo dela, destacada e rolada até ficar à vista ali; o cartão dela a abre.	Alguma unidade tem uma execução, ou o runtime está parado.	Sem Editar receitas e avaliações.

A página do datalog

O cabeçalho carrega o nome e a frase "O que é registrado: um snapshot periódico contendo todos os canais selecionados, no intervalo configurado." Todo campo salva sozinho.

Gravação

Campo	O que é	Valores / padrão	Efeito
Nome	Como o datalog se chama na árvore, no seletor Gravar de um procedimento e nos seletores de Snapshot de um painel.	Texto livre; `Novo datalog <n>` na criação.	Renomeia a linha.
Intervalo de snapshot (ms)	De quanto em quanto tempo uma amostra é gravada. A frase sob o campo diz "De quanto em quanto tempo um snapshot é registrado. 50 ms é o mais rápido que uma execução registra."	Um número inteiro de milissegundos, 50 ou mais; 1000 por padrão. Um valor menor é recusado sob o campo ("Digite um número de no mínimo 50.") e a caixa volta ao que tinha.	Define a taxa de gravação de toda execução e de toda amostra que usa este datalog.

Canais

"Canais do modelo registrados durante a execução. Eles definem as colunas da execução." O cabeçalho do cartão carrega Canal, que acrescenta uma coluna no primeiro canal legível do modelo que nenhuma linha grava ainda, e a grade tem uma linha por coluna gravada. Quando não sobra canal assim, Canal fica cinza e a dica diz por quê: "Este modelo não tem canal legível para registrar." ou "Todo canal legível do modelo já é registrado aqui."

Coluna	O que é	Valores / padrão
Canal	O canal do modelo que esta coluna grava, como `Ch<número> · <nome>`.	Só canais legíveis são oferecidos (Somente leitura e Leitura e escrita): um canal Somente escrita nunca é amostrado, então uma coluna sobre ele ficaria vazia. O seletor de cada linha oferece os canais legíveis que nenhuma outra linha grava, porque um canal em duas linhas seria uma coluna da execução sob dois títulos.
Ações de linha	Mover o canal para cima, Mover o canal para baixo (as pontas ficam cinzas), Remover (pergunta "Excluir coluna": o nome do canal, "Isso remove a coluna do datalog.").

A ordem das linhas é a ordem das colunas: é a que o arquivo da execução, o CSV e as planilhas do XLSX seguem, então as duas setas decidem como fica uma exportação. Um movimento que a estação recusa devolve a linha para onde ela estava.

Nada mais é declarado aqui. O nome, a unidade de engenharia, o tipo e a tinta de gráfico de toda coluna vêm do próprio canal. Renomear um canal reescreve esta referência junto com todas as outras do modelo, e remover um canal varre a coluna dele depois de uma confirmação que conta o que vai embora.

Onde um datalog é usado

Superfície	O que ela faz com o datalog
O estágio Registrar de um procedimento	Grava por ele durante toda execução do procedimento. A frase do estágio diz no que isso dá: "Grava 6 canais a cada 500 ms" e, num procedimento Temporizado, "…, cerca de 180 amostras por canal." Um procedimento sem datalog diz "Nada é registrado: esta execução não deixa datalog."
O cartão Comandos avulsos de um painel	Snapshot grava uma linha pelo datalog escolhido, como uma execução Instantânea que nasce e termina nos Históricos; Avaliar agora grava uma linha e a julga contra uma avaliação cujos canais o datalog grava.
Uma avaliação	Julga apenas canais que o datalog do procedimento grava: um critério cujo canal (ou canal de referência) não é coluna daquele datalog não pode ser julgado, e a página da avaliação diz isso.
Uma ocorrência armada durante uma execução	Lê as colunas gravadas, então um canal que o datalog não grava fica indisponível para ela durante a execução. Um procedimento que arma uma ocorrência sobre um canal que este datalog deixa de fora é recusado, assim como um que arma uma ocorrência e não grava nada.

Remover datalog

Remover datalog fica no grupo de perigo da barra de detalhe com o datalog selecionado, no menu de clique direito dele, e como o X no cartão da página da pasta. Ele pergunta antes ("Excluir datalog", "Isso remove o datalog e as colunas que ele registra."). Todo procedimento que gravava por ele esvazia a referência Gravar dele e sobrevive. Ele exige Editar receitas e avaliações e fica cinza sob a trava de engenharia e o runtime parado.

O que uma execução faz com ele

O Iniciar congela o layout de canais do datalog no arquivo da execução: as colunas, em ordem, cada uma com o número dela, o nome dela, o apelido em vigor na unidade, a unidade de engenharia dela e a tinta de gráfico resolvida dela. A execução as mantém através de toda edição posterior do datalog, e mesmo depois de o próprio modelo ser excluído. Cada batida grava uma amostra no nível da aplicação, contendo todas as colunas: uma origem indisponível ou um valor que não converte é guardado como uma lacuna marcada Unavailable, enquanto um valor recebido corretamente, como NaN ou uma sentinela de engenharia, continua Good. O resto do ciclo de vida está em Execuções e comentários; navegar e exportar o que foi gravado é Históricos.

O que um datalog não faz

Ele não desenha nada. Como um modelo mostra o que grava é um dashboard ou o cartão Canais de um painel.
Ele não grava nada sozinho. Um datalog que procedimento nenhum referencia e que amostra nenhuma dispara não grava linha alguma.
Ele não tem variante por unidade: toda unidade grava as mesmas colunas, sobre os vínculos dela.
Ele não filtra, não faz média e não comprime: uma linha por intervalo, todas as colunas, como lidas.