Te ofrecemos esta traducción automática para facilitar la lectura.
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.
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.
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 SELECTsum(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 SELECTcount(*) 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 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 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:
Puede hacer referencia a días específicos, incluidos today, yesterday o un día laborable. Se utilizará la aparición más reciente de un día laborable de referencia.
today - resuelve hasta la medianoche de esta mañana
yesterday - resuelve hasta la medianoche de ayer por la mañana
monday - se resuelve hasta la medianoche del lunes por la mañana más reciente
tuesday - se resuelve hasta la medianoche del martes por la mañana más reciente
wednesday - se resuelve hasta la medianoche del miércoles por la mañana más reciente
thursday - se resuelve hasta la medianoche del jueves por la mañana más reciente
friday - se resuelve hasta la medianoche del viernes por la mañana más reciente
saturday - se resuelve hasta la medianoche del sábado por la mañana más reciente
sunday - se resuelve en la medianoche del domingo por la mañana más reciente
Al hacer referencia a un día relativo, puede especificar la hora del día, anulando la hora de medianoche predeterminada. Por ejemplo: yesterday AT '01:23:45'.
La referencia horaria debe incluir la hora y el minuto, y opcionalmente el segundo. La cláusula AT time no admite la inclusión de milisegundos o referencias de zona horaria dentro de la cadena de tiempo.
Sugerencia
Tenga en cuenta que today AT [time] en una cláusula SINCE nunca hará referencia a un momento en el futuro. Si hace referencia a una hora en el futuro, el significado de today se ajustará al día anterior. Entonces, si son las 12:00 y usa la cláusula SINCE como SINCE today AT 12:01, la hora de inicio de la consulta resuelta se establecerá como ayer a las 12:01.
Puede hacer referencia a la unidad de tiempo actual ("esta") o completada más recientemente ("última").
this hour - El inicio de la hora actual (0 minutos 0 segundos).
this week - El comienzo de la semana actual. Esto se refiere a una semana laboral, por lo que this week se resuelve en el lunes por la mañana más reciente a medianoche.
this month - El comienzo del mes actual. Esto se refiere a la medianoche del primer día del mes actual.
this quarter - El inicio del trimestre actual. Esto se refiere a la medianoche del primer día del trimestre actual. Los trimestres comienzan el primero de los meses de enero, abril, julio y octubre.
this year - El comienzo del año en curso. Esto se refiere a la medianoche del primer día (1 de enero) del año en curso.
last hour - El inicio de la hora anterior.
last week - El comienzo de la semana anterior.
last month - El inicio del mes anterior.
last quarter - El inicio del trimestre anterior.
last year - El comienzo del año anterior.
En estos ejemplos, supongamos que la consulta se ejecutó el 2023-12-18T12:34:56.789Z (un lunes).
Referencia de tiempo temporal relativo
Hora resuelta (relativa a 2023-12-18T12:34:56.789Z)
NOW
(tiempo de ejecución de la consulta)
2023-12-18T12:34:56.789Z
today
2023-12-18T00:00:00.000Z
today at '01:23:45'
2023-12-18T01:23:45.000Z
today at '23:45' (después del tiempo de ejecución)
2023-12-17T23:45:00.000Z
yesterday
2023-12-17T00:00:00.000Z
yesterday at '01:23:45'
2023-12-17T01:23:45.000Z
monday
2023-12-18T00:00:00.000Z
monday at '01:23:45'
2023-12-18T01:23:45.000Z
tuesday
2023-12-12T00:00:00.000Z
tuesday at '01:23:45'
2023-12-12T01:23:45.000Z
wednesday
2023-12-13T00:00:00.000Z
wednesday at '01:23:45'
2023-12-13T01:23:45.000Z
thursday
2023-12-14T00:00:00.000Z
thursday at '01:23:45'
2023-12-14T01:23:45.000Z
friday
2023-12-15T00:00:00.000Z
friday at '01:23:45'
2023-12-15T01:23:45.000Z
saturday
2023-12-16T00:00:00.000Z
saturday at '01:23:45'
2023-12-16T01:23:45.000Z
sunday
2023-12-17T00:00:00.000Z
sunday at '01:23:45'
2023-12-17T01:23:45.000Z
this hour
2023-12-18T12:00:00.000Z
last hour
2023-12-18T11:00:00.000Z
this week
2023-12-18T00:00:00.000Z
last week
2023-12-11T00:00:00.000Z
this month
2023-12-01T00:00:00.000Z
last month
2023-11-01T00:00:00.000Z
this quarter
2023-10-01T00:00:00.000Z
last quarter
2023-07-01T00:00:00.000Z
this year
2023-01-01T00:00:00.000Z
last year
2022-01-01T00:00:00.000Z
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.
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 .
Referencia de tiempo temporal relativo
Hora resuelta (relativa a 2023-12-18T14:27:32.189Z)
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]').