

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Time-series funções
<a name="CWL_QuerySyntax-timeseries-functions"></a>

Use funções de série temporal com o `stats` comando para analisar métricas ao longo de janelas de tempo e calcular taxas de mudança.


|  Função |  Tipo de resultado |  Description | 
| --- | --- | --- | 
| `rate(fieldName: NumericLogField, interval: Period)` | número | Calcula a taxa de alteração por intervalo para um campo numérico. | 
| `count_over_time(fieldName: LogField)` | número | Conta os eventos de log por intervalo de tempo. Use com `by bin(interval)` para definir a janela. | 
| `sum_over_time(fieldName: NumericLogField)` | número | Soma os valores do campo por intervalo de tempo. Use com `by bin(interval)` para definir a janela. | 
| `histogram(fieldName: NumericLogField, buckets: number)` | mapear | Coloca os valores do campo numérico em um número especificado de intervalos de largura igual e retorna a distribuição. | 

## deslocamento
<a name="CWL_QuerySyntax-timeseries-offset"></a>

Use `offset` no final de uma `stats ... by bin()` cláusula para deslocar compartimentos de séries temporais por uma duração especificada. Isso permite comparações com mudança de horário, como comparar as métricas atuais com o mesmo período na hora ou no dia anterior.

**Sintaxe**

```
stats <aggregation> by bin(<period>) offset <duration>
```

**Exemplos**

```
stats count(*) by bin(5m) offset 1h
```

```
stats avg(latency) by bin(1m) offset 1d
```