• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Establecer el rango de tiempo de una consulta

Creamos NRQL para consultar telemetry data, y cada consulta realizada con NRQL solo considera telemetry data que se encuentran dentro de un rango de tiempo específico. Si una solicitud de consulta no especifica un rango de tiempo, de forma predeterminada informa la última hora de telemetry data . Afortunadamente, tenemos varias formas de establecer rangos de tiempo para su consulta, de modo que pueda obtener exactamente los datos que necesita en períodos de tiempo precisos.

Especificar un rango de tiempo

Puedes utilizar dos métodos para especificar el rango de tiempo en tu consulta:

  • Utilice el selector de tiempo del tablero. Al visualizar un dashboard, el rango del selector de tiempo reemplaza las cláusulas SINCE y UNTIL de una consulta, a menos que haya configurado el widget dashboard para deshabilitar el selector de tiempo.

  • Incluya SINCE y/o UNTIL. Por ejemplo:

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

Consulte la sección Especificación de una hora a continuación para obtener una lista de formatos de hora admitidos.

Usar ajuste de rango de tiempo

A veces puede ajustar los tiempos SINCE y UNTIL especificados según el tipo de consulta que ejecute con ajuste de métrica o de rango TIMESERIES .

Consulta métrica de ajuste

Consulte con métrica evento y algunos tipos de eventos de muestra pueden necesitar ajustar el rango de tiempo en función de las agregaciones de tiempo acumuladas de métrica. Por ejemplo:

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

Al observar la respuesta JSON a esta consulta, este rango de tiempo de 47 horas y 59 minutos se resuelve en agregaciones de tiempo métricas de 5 minutos, por lo que el rango de tiempo real se ajusta a los límites de agregación cercanos: "beginTime": "2023-12-20T00:00:00Z", "endTime": "2023-12-22T00:00:00Z".

TIMESERIES consulta de chasquido

Es posible que la consulta con TIMESERIES deba ajustar el intervalo de tiempo para que los resultados no incluyan un segmento de serie temporal parcial. Por ejemplo:

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

Al observar la respuesta JSON a esta consulta, los depósitos de series temporales se basan en el final del intervalo de tiempo y la hora de inicio se ajusta para que el primer depósito de la respuesta cubra 5 minutos completos: "beginTime": "2023-12-20T00:08:12Z", "endTime": "2023-12-21T00:03:12Z".

Especifique una hora con DESDE y HASTA

Tiene varias formas de especificar el tiempo en las cláusulas SINCE y hasta UNTIL .

Sugerencia

Para cada una de las opciones enumeradas a continuación, la zona horaria predeterminada es UTC. Tenga en cuenta que la zona horaria preferida del usuario no se utiliza para la ejecución de la consulta: la preferencia de zona horaria del usuario solo muestra valores de Fecha y Hora.

Si desea especificar una zona horaria distinta de UTC para el rango de tiempo, puede incluirla en la opción de cadena DateTime o puede utilizar la cláusula WITH TIMEZONE de NRQL.

Tiempo Unix (época milisegundos)

Se puede hacer referencia al tiempo como tiempo Unix en milisegundos. Este es el número de milisegundos desde 1970-01-01T00:00:00Z, o la medianoche del 1 de enero de 1970. Por ejemplo:

FROM Foo SELECT * SINCE 1702899296789 UNTIL 1702902896789

Estos valores timestamp se resuelven en un rango de tiempo que comienza en 2023-12-18T11:34:56.789Z y termina en 2023-12-18T12:34:56.789Z.

Relative time (n [time units] ago)

Se puede hacer referencia al tiempo relativo como n [time units] ago con los siguientes componentes:

  • n: Un valor entero positivo.
  • [time units]: Las unidades de tiempo disponibles incluyen milliseconds, seconds, minutes, hours, days, weeks, months (definido como 30 días), quarters (definido como 91 días) o years (definido como 365 días). La pluralización de unidades de tiempo es opcional, por lo que puedes dejar la "s" al final de la unidad. 2 day ago y 2 days ago tienen el mismo significado.

El tiempo es relativo al momento en que ejecuta la consulta. Por ejemplo, supongamos que ejecutó una consulta en 2023-12-18T12:34:56.789Z. Obtendría resultados diferentes según el valor de tiempo relativo que utilizó:

Referencia de tiempo relativo

Hora resuelta (UTC)

NOW (tiempo de ejecución de la consulta)

2023-12-18T12:34:56.789Z

2 milliseconds ago

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

2 seconds ago

2023-12-18T12:34:54.789Z

2 minutes ago

2023-12-18T12:32:56.789Z

2 hours ago

2023-12-18T10: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

Tiempo temporal relativo

También puede utilizar el tiempo relativo utilizando referencias de tiempo temporal. Estas referencias de tiempo relativas se resuelven al comienzo del intervalo de tiempo temporal. Una referencia de tiempo temporal relativa respetará una cláusula WITH TIMEZONE . Seleccione uno de los colapsadores a continuación para ver más información sobre referencias de tiempo temporales específicas:

Utilice una cadena de fecha y hora

Puede especificar un rango de tiempo utilizando una cadena DateTime. El analizador generalmente admite el formato Fecha y hora ISO 8601: '2023-12-18T12:34:56.789-06:00'. Pero el analizador DateTime también puede reconocer variantes del formato estándar ISO, como '2023-12-18 12:34'. El analizador también admite cadenas de solo fecha ('2023-12-18') y de solo hora ('12:34:56'). Tenemos las opciones y ejemplos para usar una cadena DateTime a continuación:

Campo

Detalles

Estructura general

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

Fecha

Año mes dia

  • Year - (obligatorio) valor del año de 4 dígitos.

  • Month - (obligatorio) valor mensual de 2 dígitos.

  • Day - (opcional) valor del día de 2 dígitos.

    Una cadena DateTime puede incluir un Date sin una hora, con el valor de hora predeterminado a medianoche al comienzo de la fecha determinada. Los guiones entre los elementos de fecha son opcionales (pero recomendados), por lo que '20231218' equivale a '2023-12-18'.

Separador de tiempo

Separa la fecha y la hora en una cadena DateTime completa. Los valores de separación válidos son la letra mayúscula T o un solo espacio.

Tiempo

Hour:Minute[[:Second].FractionalSecond]

  • Hour - (requerido) Valor de hora de 1 o 2 dígitos, 00-23. Se recomiendan 2 dígitos, según la especificación ISO 8601.

  • Minute - (obligatorio) Valor de minutos de 2 dígitos, 00-59.

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

  • [.FractionalSecond] - (opcional) Valor de fracción de segundo (milisegundos) de 1 a 3 dígitos, 000-999. Solo disponible cuando se incluye un valor :Second .

    Una cadena DateTime puede incluir una hora sin fecha, y el valor de fecha predeterminado es el día actual. Cuando se proporciona una hora sin fecha en la cláusula SINCE , si la hora es futura, se utilizará el día anterior para la fecha.

    Cuando una hora sigue a T, los dos puntos son opcionales (pero recomendados). Si se excluyen los dos puntos, la hora debe incluir 2 dígitos y no se permiten AM/PM. Entonces, '20231218T123456.789' es equivalente a '2023-12-18T12:34:56.789'.

Zona horaria

Opcional : si TimeZone no está incluido en una cadena DateTime, se usará la zona horaria indicada en la cláusula WITH TIMEZONE de la consulta, si está presente; de lo contrario, se usará la zona horaria UTC.

Opcionalmente, el valor TimeZone puede ir precedido de un espacio. Se puede indicar en varios formatos.

  • Desplazamiento: indica las horas y minutos de la zona horaria en relación con UTC.

    (+|-)Hours[:]Minutes - es decir Más o menos, horas de 2 dígitos, dos puntos opcionales y finalmente minutos de 2 dígitos. También se admite la letra Z , que representa UTC o un desplazamiento de cero.

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

  • ID de zona entre corchetes: un ID de zona es un nombre textual de una zona horaria. La mayoría de los ID de zona (pero no todos) constan de una región seguida de una barra diagonal y luego una subregión. Una ventaja de utilizar un ID de zona basado en la región es que el analizador DateTime se ajustará automáticamente a las reglas de horario de verano de la zona.

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

    Consulte la lista de ID de zona disponibles.

    Tenga en cuenta que los ID de zona no funcionan cuando se usa AM/PM.

AM/PM

AM o se puede agregar PM al final de una cadena DateTime. Si está presente, el valor Hour se interpreta como un valor de 12 horas en lugar de un valor de 24 horas, con un rango de 01 a 12 en lugar de 00 a 23.

Tenga en cuenta que AM/PM no se admite con el formato de ID de zona TimeZone .

Zonas horarias

ID de zona

Los siguientes ID de zona son válidos para la cláusula WITH TIMEZONE o como referencia de zona horaria entre corchetes en una cadena de fecha y hora (por ejemplo, '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.