Permanência

Permanência é o tempo que uma entidade passa em cada valor de um campo discreto: a duração de um reembolso em pendente, o intervalo de uma transação entre duas etapas, o tempo decorrido de um cadastro em bloqueio.

O acompanhamento é uma capacidade do campo, não um tipo de métrica isolado. Ao marcar um campo como rastreável, a plataforma passa a registrar cada troca de valor por entidade e provisiona dois campos derivados, disponíveis como qualquer outro campo do tipo de evento:

Campo derivado	Tipo	Conteúdo
<campo> anterior	dimensão	valor em que a entidade estava antes da troca
Tempo em <campo> anterior	medição	duração da permanência encerrada mais recentemente

Permanências concluídas

Uma permanência concluída é medida com uma métrica comum: use uma agregação de Média, Máximo, Mínimo ou Soma sobre o campo Tempo em <campo> anterior e agrupe pela dimensão <campo> anterior.

A métrica resultante expressa a latência do processo: o tempo médio de permanência em cada valor e a maior permanência observada.

Permanências em aberto

Uma permanência em aberto ainda não foi encerrada: a entidade permanece no valor. A plataforma amostra esse conjunto periodicamente e oferece duas medidas:

Medida	Conteúdo
Quantidade em aberto	número de entidades atualmente no valor
Tempo em aberto	idade da entidade mais antiga em aberto

O campo rastreado precisa ter um conjunto fixo de valores (lista ou booleano), porque cada valor é acompanhado separadamente.

Sem um filtro no campo rastreado, a métrica acompanha todos os valores, inclusive os finais, cuja contagem cresce até o dado expirar. Filtre o campo rastreado para acompanhar apenas os valores relevantes.

Restringir por tempo em aberto

Uma métrica em aberto aceita uma restrição adicional, Recorte da permanência, que limita a contagem às entidades abertas há mais de um determinado tempo.

A restrição distingue um processo travado de uma entidade lenta. Sem ela, Quantidade em aberto inclui as entidades recém-chegadas ao valor. Com mais de 2 dias, a medida passa a contar apenas as entidades que ultrapassaram o prazo esperado.

O valor precisa ser menor que a retenção da permanência configurada no campo. Abaixo do limite informado, Tempo em aberto registra zero em vez da idade real da entidade mais antiga.

O limiar de alerta não faz parte da métrica: é configurado como condição no monitoramento.

Restrições das métricas em aberto

• Uma medição em aberto suporta apenas uma dimensão de agrupamento. Para desmembrar por mais de uma dimensão, crie uma métrica por dimensão.
• A dimensão escolhida precisa estar entre as dimensões de recorte configuradas no campo rastreável.
• Uma medição em aberto não pode dividir a métrica com medições comuns.
• Dimensões de recorte adicionadas depois valem apenas para as entidades que entrarem no valor a partir daquele momento. As já abertas permanecem sem o recorte até trocarem de valor.