Compartilhar via


Configurações de detecção no Activator

Este artigo descreve a gama de configurações de detecção disponíveis ao criar uma regra. Você aprenderá como as configurações de detecção operam no Fabric Activator e como defini-las de maneira eficaz. As diversas configurações de detecção trabalham em conjunto para identificar os dados exatos que você deseja monitorar.

Nosso exemplo usa o eventstream de exemplo Eventos de entrega de pacotes. Neste fluxo de eventos, já foi criado um objeto chamado Temperatura e uma regra Muito quente para medicamentos.

Opções de configuração de detecção

As configurações de detecção são gerenciadas no painel Definição, que é aberto no lado direito do Activator. Selecione uma regra no Explorer ou clique em Nova regra para abrir o painel Definição. Nele, é possível definir as configurações de detecção usando Resumo, Filtro e Condição.

Captura de tela da abertura do painel Definição no Activator.

Resumo

Um resumo é composto de uma agregação (média, mínimo, soma etc.), o tamanho da janela e o tamanho da etapa para o atributo usado na regra. Neste exemplo, você usará o objeto Temperatura como atributo. O objeto Temperatura é proveniente do fluxo de Eventos de entrega de pacotes.

Se a seção Resumo não for exibida no painel Definição, selecione Adicionar resumo para abri-la.

Ao criar um resumo, você especifica uma janela de tempo para a regra. A janela de tempo varia de 10 segundos a 24 horas. Um resumo converte todos os valores das propriedades da regra durante cada janela de tempo em um único valor de resumo para a janela de tempo. Neste exemplo, o resumo de regras é a agregação Média do atributo Temperatura.

Captura de tela mostrando a seção Monitorar do painel Definição com o atributo Temperatura selecionado.

O resumo também inclui um tamanho de etapa. O tamanho da etapa varia de 10 segundos a 24 horas.

Tipo de resumo Descrição
Média ao longo do tempo Calcula o valor médio da propriedade ou coluna ao longo da janela de tempo.
Count Calcula o número de eventos que contêm a propriedade ou a coluna ao longo da janela de tempo.
Valor mínimo/máximo ao longo do tempo Calcula o valor mínimo/máximo da propriedade ou coluna durante a janela de tempo.
Total Calcula o valor total da propriedade ou coluna durante a janela de tempo.

Filtros

O painel Definição tem um botão para Adicionar filtro e uma seção chamada Filtro de propriedade. Aqui estamos explicando o botão Adicionar filtro.

Em um filtro, você especifica uma operação de comparação para o atributo selecionado. O filtro retém apenas os eventos que atendem à condição de comparação. Todos os outros eventos não são considerados pela regra.

Captura de tela do uso de um filtro do Activator.

Use filtros em qualquer tipo de atributo. Os filtros criam uma condição em um subconjunto de seus dados. Por exemplo, é possível definir um filtro de “City=Redmond” em alguns eventos de rastreamento de pacotes para definir uma condição somente em eventos de pacotes em Redmond. Também é possível definir um filtro com base em dados numéricos. No exemplo, foi feita a filtragem por temperaturas maiores que 60. Os eventos que não se ajustam às condições de filtro não são incluídos.

Você pode especificar até três filtros.

Condições

A terceira configuração de detecção é Condição. Use a Condição para informar ao Activator quando ativar a regra.

Captura de tela do uso de tipos de condição do Activator.

Os tipos de condição se enquadram nas seguintes categorias:

Tipo de condição Descrição
Condições É As condições É são ativadas para cada evento em que a condição é verdadeira.
Condições Torna-se Condições Torna-se são ativadas somente quando a condição se torna verdadeira, depois de ser falsa. Por exemplo, "Torna-se maior que 10" é ativada quando o valor da propriedade muda de um valor de cinco (menor que 10) para um valor de 11 (maior que 10). Essa condição só é ativada quando passa de falsa para verdadeira.
Condições Entra no Intervalo/Sai do Intervalo A condição Entra no Intervalo é ativada quando um valor de propriedade entra em um intervalo de valores definido. Ela só é ativada quando o valor anterior da propriedade estava fora do intervalo e o valor atual está dentro do intervalo. A condição Sai do Intervalo é semelhante, exceto em que ela é ativada quando o valor da propriedade sai do intervalo.
É Alterada, É Alterada para, É Alterada de Essas condições são ativadas quando uma condição muda ou quando muda de/para limites especificados.
Estados de texto como Contém, Termina com e Começa com Essas condições são ativadas quando o texto atende à condição selecionada.
Condições de Pulsação As condições "Sem dados" são ativadas quando os dados não chegam ao Activator. O tempo decorrido é o tempo que você deseja que a regra monitore caso novos dados não cheguem.

Depois de especificar um tipo de condição, você especifica uma ocorrência.

A ocorrência indica por quanto tempo, ou quantas vezes, a condição deve ser verdadeira antes que a regra seja ativada.

Temporizador Descrição
Sempre Ative a regra sempre que a condição for verdadeira.
Número de vezes Conte quantas vezes a condição é verdadeira e ative a regra somente quando ela se tornar verdadeira o número especificado de vezes.
Permanece Ative a regra se a condição for continuamente verdadeira pelo período de tempo especificado.

Configurações avançadas

Para saber mais sobre as configurações avançadas, consulte Latência no Ativador.

Você também pode saber mais sobre o Microsoft Fabric: