Documentação do Oracle Cloud Infrastructure

Selecionando uma Resolução Não Padrão para uma Consulta

Especifique um valor não padrão para resolução para consultar dados de métrica no serviço Monitoring.

Observação

Essas instruções só se aplicam a consultas de métrica (SummarizeMetricsData). A resolução não pode ser selecionada para consultas de alarme (CreateAlarm). O único valor válido da resolução de uma solicitação de consulta de alarme é 1m.
Ilustração

Como mostrado na ilustração a seguir, a resolução controla o horário inicial de cada janela de agregação em relação à janela anterior, enquanto o intervalo controla o tamanho das janelas. As duas solicitações aplicam a estatística max aos dados em cada janela de cinco minutos (do intervalo), resultando em um único ponto de dados agregado que representa o maior contador CPUutilization para essa janela. Somente o valor da resolução é diferente. Essa resolução altera a regularidade com que as janelas de agregação mudam ou os horários iniciais das sucessivas janelas de agregação. A Solicitação A não especifica uma resolução e, portanto, usa o valor padrão igual ao intervalo (5 minutos). As janelas de agregação de cinco minutos dessa solicitação são obtidas dos conjuntos de pontos de dados emitidos de 0:n a 5:00, 5:n a 10:00, e assim por diante. A solicitação B especifica uma resolução de 1 minuto; portanto, suas janelas de agregação de cinco minutos são obtidas do conjunto de pontos de dados emitidos a cada minuto, de 0:n a 5:00, 1:n a 6:00, e assim por diante.

Esta imagem mostra como as janelas de agregação começam de acordo com a resolução.

Para solucionar problemas de consulta, consulte Diagnosticando e Solucionando Problemas de Consultas.

Considerações

Para consultas de métrica, o intervalo  selecionado conduz à resolução  padrão da solicitação, que determina o intervalo de tempo máximo dos dados retornados.

Intervalo de tempo máximo retornado para uma consulta

O intervalo de tempo máximo retornado para uma consulta de métrica depende da resolução. Por padrão, para consultas de métrica, a resolução é a mesma do intervalo de consulta.

O intervalo de tempo máximo é calculado usando o horário atual, independentemente de qualquer horário final especificado. A seguir estão os intervalos de tempo máximos retornados para cada seleção de intervalo disponível na Console (Modo básico).

Intervalo Resolução padrão (consultas de métrica) Intervalo de tempo máximo retornado

1 minuto

Auto (Métricas do Serviço página)*, quando o período selecionado é de 6 horas ou menos

 1 minuto 7 dias

5 minutos

Auto (Métricas do Serviço página)*, quando o período selecionado é maior que 6 horas e menor que 36 horas

 5 minutos 30 dias

1 hora

Auto (página Métricas do Serviço)*, quando o período selecionado é mais de 36 horas

 1 hora 90 dias

1 dia

 1 dia 90 dias

* O intervalo de tempo máximo retornado quando você seleciona Auto para Intervalo (Métricas do Serviço apenas) é determinado pela seleção automática de intervalo. A seleção automática de intervalo é baseada no período selecionado.

Para especificar uma resolução não padrão diferente do intervalo, consulte Selecionando uma Resolução Não Padrão para uma Consulta.

Exemplo 1 para Dados Retornados
Intervalo e resolução de um minuto até a hora atual, enviados às 10:00 em 8 de janeiro. Nenhuma resolução ou horário final foi especificado, portanto, a resolução assume como padrão o valor do intervalo de 1m, e o horário final é definido como o horário atual (2023-01-08T10:00:00.789Z). Esta solicitação retorna um máximo de 7 dias de pontos de dados da métrica. O ponto de dados mais antigo possível dentro desse período de sete dias seria 10:00 em 1º de janeiro (2023-01-01T10:00:00.789Z).
Exemplo 2 para Dados Retornados
Intervalo de cinco minutos com uma resolução de um minuto até dois dias atrás, enviado às 10:00 em 8 de janeiro. Como a resolução conduz ao intervalo de tempo máximo, é retornado um máximo de 7 dias de pontos de dados da métrica. Embora o horário final especificado seja 10:00 em 6 de janeiro (2023-01-06T10:00:00.789Z), o ponto de dados mais antigo possível nesse período de sete dias seria 10:00 em 1º de janeiro (2023-01-01T10:00:00.789Z). Portanto, apenas 5 dias de pontos de dados da métrica podem ser retornados neste exemplo.
  • Essa tarefa não pode ser executada usando a Console.

  • Use o comando oci monitoring métrica-data resumeize-metrics-data e os parâmetros necessários para consultar dados de métricas. Use o parâmetro --resolution para selecionar uma resolução não padrão para a consulta.

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

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.

  • Execute a operação SummarizeMetricsData para consultar dados de métrica. Use o atributo resolution para selecionar uma resolução não padrão para a consulta.