Documentación de Oracle Cloud Infrastructure

Selección de una resolución no por defecto para una consulta

Especifique un valor no por defecto de resolución para la consulta de datos de métricas en Monitoring.

Nota

Estas instrucciones se aplican solo a consultas de métricas (SummarizeMetricsData). La resolución no se puede seleccionar para consultas de alarma (CreateAlarm). El único valor válido de la resolución para una solicitud de consulta de alarma es 1m.
Ilustración

Como se muestra en la siguiente ilustración, la resolución controla la hora de inicio de cada periodo de agregación en relación con el periodo anterior, mientras que el intervalo controla la duración de cada periodo. Ambas solicitudes aplican la estadística max a los datos de cada intervalo de cinco minutos (dentro del intervalo), lo que da como resultado un único punto de datos agregado que representa el contador CPUutilization más alto para el intervalo en cuestión. Solo varía el valor de resolución. La resolución varía la regularidad con la que cambian los intervalos de agregación, o las horas de inicio de los intervalos de agregación sucesivos. La solicitud A no especifica una resolución y, por tanto, utiliza el valor por defecto, es decir, el mismo que para el intervalo (5 minutos). Los periodos de agregación de cinco minutos de esta solicitud se obtienen de los conjuntos de puntos de datos emitidos de 0:n a 5:00, 5:n a 10:00, y así sucesivamente. La solicitud B especifica una resolución de 1 minuto, por tanto, los intervalos de agregación de cinco minutos se obtienen de los conjuntos de puntos de datos emitidos cada minuto de 0:n a 5:00, 1:n a 6:00, y así sucesivamente.

En esta imagen se muestra cómo comienzan los intervalos de agregación según la resolución.

Para solucionar problemas de consulta, consulte Solución de problemas de consultas.

Consideraciones

En las consultas de métricas, el intervalo  seleccionado controla la resolución  por defecto de la solicitud, lo cual determina el intervalo máximo de tiempo de los datos obtenidos.

Intervalo de tiempo máximo devuelto para una consulta

El intervalo de tiempo máximo devuelto para una consulta de una métrica depende de la resolución. Por defecto, para las consultas de métricas, la resolución se corresponde con el intervalo de consulta.

El intervalo de tiempo máximo se calcula utilizando la hora actual, independientemente de la hora de finalización especificada. A continuación se muestran los rangos de tiempo máximos devueltos para cada selección de intervalo disponible en la consola (modo básico).

Intervalo Resolución por defecto (consultas de métricas) Intervalo de tiempo máximo devuelto

1 minuto

Automático (página Métricas de servicio)*, cuando el período de tiempo seleccionado es de 6 horas o menos

 1 minuto 7 días

5 minutos

Automático (página Métricas de servicio)*, cuando el período de tiempo seleccionado es superior a 6 horas e inferior a 36 horas

 5 minutos 30 días

1 hora

Automático (página Métricas de servicio)*, cuando el período de tiempo seleccionado es superior a 36 horas

 1 hora 90 días

1 día

 1 día 90 días

* El rango de tiempo máximo que se devuelve cuando selecciona Automático en Intervalo (sólo en la página Métricas de servicio) viene determinado por la selección automática del intervalo. La selección automática de intervalos se basa en el período de tiempo seleccionado.

Para especificar una resolución que no sea el valor por defecto y que difiera del intervalo, consulte Selección de una Resolución No por Defecto para una Consulta.

Ejemplo 1 para datos devueltos
Intervalo y resolución de un minuto hasta la hora actual, enviado el 8 de enero a las 10:00. No se ha especificado ninguna hora de resolución ni de finalización, por lo que la resolución se establece por defecto en el valor de intervalo 1m y la hora de finalización se define por defecto en la hora actual (2023-01-08T10:00:00.789Z). Esta solicitud devuelve un máximo de 7 días de puntos de datos de métrica. El primer punto de datos posible dentro de este período de siete días sería el 1 de enero a las 10:00 (2023-01-01T10:00:00.789Z).
Ejemplo 2 para datos devueltos
Intervalo de cinco minutos con resolución de un minuto hasta hace dos días, enviado el 8 de enero a las 10:00. Debido a que la resolución controla el intervalo de tiempo máximo, se devuelve un máximo de 7 días de puntos de datos de métrica. Si bien la hora de finalización especificada era el 6 de enero a las 10:00 (2023-01-06T10:00:00.789Z), el primer punto de datos posible dentro de este período de siete días sería el 1 de enero a las 10:00 (2023-01-01T10:00:00.789Z). Por tanto, en este ejemplo solo se pueden devolver 5 días de puntos de datos de métrica.
  • Esta tarea no se puede realizar con la consola.

  • Utilice el comando oci monitoring metric-data summarize-metrics-data y los parámetros necesarios para consultar datos de métricas. Utilice el parámetro --resolution para seleccionar una resolución no por defecto para la consulta.

    oci monitoring metric-data summarize-metrics-data --resolution <resolution> [...]

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Command Line Reference for Monitoring.

  • Ejecute la operación SummarizeMetricsData para consultar datos de métricas. Utilice el atributo resolution para seleccionar una resolución no por defecto para la consulta.