• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

Definir o intervalo de tempo de uma consulta

Criamos o NRQL para consultar dados de telemetria, e toda consulta feita com NRQL considera apenas dados de telemetria que estão dentro de um intervalo de tempo especificado. Se uma solicitação de consulta não especificar um intervalo de tempo, o padrão será relatar a última hora dos dados de telemetria por padrão. Felizmente, temos várias maneiras de definir intervalos de tempo para sua consulta, para que você possa obter exatamente os dados necessários em intervalos de tempo precisos.

Especifique um intervalo de tempo

Você pode usar dois métodos para especificar o intervalo de tempo em sua consulta:

  • Use o seletor de hora do painel. Ao visualizar um dashboard, o intervalo do seletor de hora substitui as cláusulas SINCE e UNTIL de uma consulta, a menos que você tenha configurado o widget dashboard para desativar o seletor de hora.

  • Incluir SINCE e/ou UNTIL. Por exemplo:

    FROM Foo SELECT * SINCE 2 days ago UNTIL 1 day ago

Consulte a seção Especificando uma hora abaixo para obter uma lista de formatos de hora suportados.

Usar ajuste de intervalo de tempo

Às vezes, você pode ajustar os tempos SINCE e UNTIL especificados, dependendo do tipo de consulta executada com ajuste de intervalo métrico ou TIMESERIES .

Ajuste de consulta métrica

consulta com evento de métrica e alguns tipos de eventos de amostra podem precisar ajustar o intervalo de tempo com base nas agregações de tempo de roll-up da métrica. Por exemplo:

FROM Metric SELECT sum(foo.count) SINCE '2023-12-20T00:04Z' UNTIL '2023-12-22T00:03Z'

Observando a resposta JSON a esta consulta, esse intervalo de tempo de 47 horas e 59 minutos é resolvido para agregações de tempo métrica de 5 minutos, de modo que o intervalo de tempo real se ajusta aos limites de agregação próximos: "beginTime": "2023-12-20T00:00:00Z", "endTime": "2023-12-22T00:00:00Z".

TIMESERIES ajuste de consulta

Consulta com TIMESERIES pode precisar ajustar o intervalo de tempo para que os resultados não incluam um intervalo de série temporal parcial. Por exemplo:

FROM Foo SELECT count(*) TIMESERIES 5 minutes SINCE '2023-12-20T00:04:59Z' UNTIL '2023-12-21T00:03:12Z'

Observando a resposta JSON a esta consulta, os intervalos de série temporal se baseiam no final do intervalo de tempo e o horário de início é ajustado para que o primeiro intervalo na resposta cubra cinco minutos completos: "beginTime": "2023-12-20T00:08:12Z", "endTime": "2023-12-21T00:03:12Z".

Especifique um horário com SINCE e UNTIL

Você tem algumas maneiras de especificar o tempo nas cláusulas SINCE e até UNTIL .

Dica

Para cada uma das opções listadas abaixo, o fuso horário padrão é UTC. Observe que o fuso horário preferido do usuário não é usado para execução de consulta: a preferência de fuso horário do usuário exibe apenas valores DateTime.

Se quiser especificar um fuso horário diferente do UTC para o intervalo de tempo, você poderá incluí-lo na opção de string DateTime ou usar a cláusula WITH TIMEZONE do NRQL.

Tempo Unix (época milissegundos)

O tempo pode ser referenciado como tempo Unix em milissegundos. Este é o número de milissegundos desde 1970-01-01T00:00:00Z ou meia-noite de 1º de janeiro de 1970. Por exemplo:

FROM Foo SELECT * SINCE 1702899296789 UNTIL 1702902896789

Esses valores timestamp são resolvidos para um intervalo de tempo começando em 2023-12-18T11:34:56.789Z e terminando em 2023-12-18T12:34:56.789Z.

Relative time (n [time units] ago)

O tempo relativo pode ser referenciado como n [time units] ago com os seguintes componentes:

  • n: Um valor inteiro positivo.
  • [time units]: as unidades de tempo disponíveis incluem milliseconds, seconds, minutes, hours, days, weeks, months (definido como 30 dias), quarters (definido como 91 dias) ou years (definido como 365 dias). A pluralização da unidade de tempo é opcional, portanto você pode deixar o “s” fora do final da unidade. 2 day ago e 2 days ago têm o mesmo significado.

A hora é relativa à hora em que você executa a consulta. Por exemplo, suponha que você executou uma consulta em 2023-12-18T12:34:56.789Z. Você obteria resultados diferentes dependendo do valor de tempo relativo usado:

Referência de tempo relativo

Hora resolvida (UTC)

NOW (tempo de execução da consulta)

2023-12-18T12:34:56.789Z

2 milliseconds ago

2023-12-18T12:34:54..787Z

2 seconds ago

18/12/2023T12:34:54 0,789Z

2 minutes ago

18/12/2023T12:32:56.789Z

2 hours ago

18/12/202310:34:56.789Z

2 days ago

2023-12-16T12:34:56.789Z

2 weeks ago

2023-12-04T12:34:56.789Z

2 months ago

2023-10-19T12:34:56.789Z

2 quarters ago

2023-06-19T12:34:56.789Z

2 years ago

2021-12-18T12:34:56.789Z

Tempo temporal relativo

Você também pode usar o tempo relativo usando referências de tempo temporal. Essas referências de tempo relativo são resolvidas no início do intervalo de tempo temporal. Uma referência de tempo temporal relativo respeitará uma cláusula WITH TIMEZONE . Selecione um recolhido abaixo para ver mais informações sobre referências de tempo temporal específicas:

Use uma string DateTime

Você pode especificar um intervalo de tempo usando uma string DateTime. O analisador geralmente suporta o formato DateTime ISO 8601: '2023-12-18T12:34:56.789-06:00'. Porém, o analisador DateTime também pode reconhecer variantes do formato padrão ISO, como '2023-12-18 12:34'. O analisador também oferece suporte a strings somente de data ('2023-12-18') e somente de hora ('12:34:56'). Temos as opções e exemplos para usar uma string DateTime abaixo:

Campo

Detalhes

Estrutura geral

[Date][TimeSeparator][Time][TimeZone][AM/PM]

Data

Ano mês dia

  • Year - (obrigatório) valor do ano com 4 dígitos.

  • Month - (obrigatório) valor do mês com 2 dígitos.

  • Day - (opcional) valor do dia com 2 dígitos.

    Uma string DateTime pode incluir um Date sem uma hora, com o valor de hora padronizado como meia-noite no início da data especificada. Os traços entre os elementos de data são opcionais (mas recomendados), portanto '20231218' é equivalente a '2023-12-18'.

Separador de tempo

Separa a data e a hora em uma string DateTime completa. Os valores de separação válidos são a letra maiúscula T ou um único espaço.

Tempo

Hour:Minute[[:Second].FractionalSecond]

  • Hour - (obrigatório) valor de hora com 1 ou 2 dígitos, 00-23. Recomenda-se 2 dígitos, de acordo com a especificação ISO 8601.

  • Minute - (obrigatório) valor de minuto de 2 dígitos, 00-59.

  • :Second - (opcional) valor de segundos de 2 dígitos, 00-59.

  • [.FractionalSecond] - (opcional) valor de segundo fracionário (milissegundos) de 1 a 3 dígitos, 000-999. Disponível somente quando um valor :Second é incluído.

    Uma string DateTime pode incluir uma hora sem data, com o valor de data padronizado para o dia atual. Quando um horário é fornecido sem uma data na cláusula SINCE , se o horário estiver no futuro, o dia anterior será usado como data.

    Quando um Time segue um T, os dois pontos são opcionais (mas recomendados). Se os dois pontos forem excluídos, a Hora deverá incluir 2 dígitos e AM/PM não será permitido. Então, '20231218T123456.789' é equivalente a '2023-12-18T12:34:56.789'.

Fuso horário

Opcional - Se TimeZone não estiver incluído em uma string DateTime, o fuso horário indicado na cláusula WITH TIMEZONE da consulta será usado, se estiver presente, caso contrário, o fuso horário UTC será usado.

O valor TimeZone pode opcionalmente ser precedido por um espaço. Pode ser indicado em vários formatos.

  • Offset - Indica as horas e minutos do fuso horário em relação ao UTC.

    (+|-)Hours[:]Minutes - ou seja Mais ou menos, horas de 2 dígitos, dois pontos opcionais e, finalmente, minutos de 2 dígitos. A letra Z também é suportada, representando UTC ou um deslocamento de zero.

    Exemplos: -0600, Z, +0530, +05:30

  • ID de zona entre colchetes - Um ID de zona é um nome textual de um fuso horário. A maioria dos IDs de zona (mas não todos) consiste em uma região seguida por uma barra e depois por uma sub-região. Uma vantagem de usar um ID de zona baseado em região é que o analisador DateTime se ajustará automaticamente às regras de horário de verão da zona.

    Exemplos: [America/Los_Angeles], [Etc/GMT-6], [UTC]

    Consulte a lista de IDs de zona disponíveis.

    Observe que os IDs de zona não funcionam ao usar AM/PM.

AM/PM

AM ou PM pode ser adicionado ao final de uma string DateTime. Se presente, o valor Hour será interpretado como um valor de 12 horas em vez de um valor de 24 horas, com um intervalo de 01 a 12 em vez de 00 a 23.

Observe que AM/PM não é compatível com o formato de ID de zona TimeZone .

Fusos horários

IDs de zona

Os IDs de zona a seguir são válidos para a cláusula WITH TIMEZONE ou como uma referência de fuso horário entre colchetes em uma string de data e hora (por exemplo, '2023-12-18T12:34 [America/Los_Angeles]').

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.