Com o NRQL, você pode criar consultas que agrupam resultados ao longo do tempo. Por exemplo, você pode agrupar os resultados com base no carimbo de data/hora, separando-os em grupos que cobrem um intervalo especificado de datas e horas.
Ao utilizar as funções de tempo da tabela abaixo na consulta NRQL, os resultados retornam em UTC. Para ajustar os resultados ao seu fuso horário, inclua a cláusulaWITH TIMEZONE na sua consulta.
Time-based function | Description | String format | Numeric format |
|---|---|---|---|
| Retorna o ano de um timestamp. |
|
|
| Retorna o trimestre do ano. O valor retornado inclui o trimestre e o ano quando formatado como uma string. |
|
|
| Retorna o mês e o ano do timestamp de data/hora quando formatado como uma string ou o mês numérico quando formatado como um número. |
|
|
| Retorna a semana em que ocorreu o timestamp , nomeando o mês e o dia da segunda-feira daquela semana. |
| N/A |
| Retorna o dia da semana do timestamp. O valor retornado retorna no final da semana, permitindo que você observe as tendências por dia da semana ao longo do tempo. |
|
|
| Retorna a data do timestamp. O valor retornado inclui mês, dia e ano. |
| N/A |
| Retorna a data numérica dentro de um único mês do timestamp, um valor de 1 a 31. O valor retornado não inclui o mês. |
|
|
| Retorna o número de dias do mês do timestamp. |
|
|
| Retorna a hora do timestamp. O valor retornado não inclui um 0 prefixado para horas entre 1h e 9h. Isso difere de funções e cláusulas como |
|
|
| Retorna o minuto do timestamp. O valor retornado não inclui um 0 prefixado para minutos entre 1 e 9. Isso difere de funções e cláusulas como |
|
|
Defina o intervalo de tempo da sua consulta NRQL
Dica
Nestes exemplos, usamos um atributo de timestamp personalizado enviado com o evento PageView chamado createdAt. Para definir o momento da ingestão do evento PageView, você pode usar o atributo timestamp .
Para criar sua consulta NRQL, use uma cláusulaFACET com uma função de bucket que funciona com um atributo timestamp . Execute uma consulta FACET padrão, mas em vez de facetar por um atributo, facetar por tempo. Por exemplo:
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt)Para executar várias funções na mesma consulta, use o recurso multifacetado do NRQL:
SELECT count(*) FROM K8sDaemonsetSample FACET dateOf(createdAt), monthOf(createdAt)Muitas funções baseadas em tempo aceitam um segundo argumento opcional de string (o padrão) ou numeric, que controla o formato do valor do resultado.
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt, numeric)