Documentação do Oracle Cloud Infrastructure

Selecionando uma Resolução Não-padrão para uma Consulta

Especifique um valor não default 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. Ambas as solicitações aplicam a estatística max aos dados dentro de cada janela de cinco minutos (do intervalo), resultando em um único ponto de dados agregado representando o contador CPUutilization mais alto dessa 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 diagnosticar e solucionar problemas de consulta, consulte Solucionando Problemas de Pesquisas.

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 as faixas de tempo máximas retornadas para cada seleção do 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

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

 1 minuto 7 dias

5 minutos

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

 5 minutos 30 dias

1 hora

Automático (página Métricas de Serviço)*, quando o período selecionado é maior que 36 horas

 1 hora 90 dias

1 dia

 1 dia 90 dias

* A faixa de tempo máxima retornada quando você seleciona Automático para a página Intervalo (apenas Métricas de Serviço) é determinada pela seleção de intervalo automático. A seleção automática de intervalo é baseada no período selecionado.

Para especificar uma resolução não padrão que difere do intervalo, consulte Selecionando uma Resolução Não Default para uma Consulta.

Exemplo 1 para Dados Retornados
Intervalo de um minuto e resolução até o horário 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 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 metric-data summarize-metrics-data e os parâmetros obrigatórios para consultar dados de métrica. 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 CLI, consulte a Referência de Linha de Comandos para Monitoramento.

  • 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.