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 Gravar 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 reutilizáveis: um intervalo de amostragem periódica e os canais capturados em toda execução que referencia uma.") 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. Acrescente 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 `Datalog <n>` a 1000 ms, sem colunas, e o seleciona.	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 é gravado: uma amostra periódica contendo todo canal escolhido, 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; `Datalog <n>` na criação.	Renomeia a linha.
Intervalo de amostragem (ms)	De quanto em quanto tempo uma amostra é gravada. A frase sob o campo diz "De quanto em quanto tempo uma amostra é gravada. 50 ms é o mais rápido que uma execução grava."	Um número inteiro de milissegundos, 50 ou mais; 1000 por padrão. Um valor menor é recusado sob o campo ("Informe um número de pelo menos 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 gravados durante a execução. Eles definem as colunas da execução." O cabeçalho do cartão carrega Canal, que acrescenta uma coluna, e a grade tem uma linha por coluna gravada.

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. Uma linha nova começa no primeiro canal legível do modelo; quando o modelo não tem nenhum, a linha é acrescentada com o seletor vazio.
Ações de linha	Mover canal para cima, Mover canal para baixo (as pontas ficam cinzas), Remover (pergunta "Excluir coluna": o nome do canal, "Isto 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. A grade não impede você de listar o mesmo canal em duas linhas; cada linha vira uma coluna própria.

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 Gravar 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 é gravado: esta execução não deixa datalog."
O cartão Comandos únicos 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", "Isto remove o datalog e as colunas que ele grava."). 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 um vazio marcado 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.