# 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](/pt/events/event_fields/#rastrear-permanência), 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](/pt/behavioral/monitors/open_tracking/).

### 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.