Documentação do Oracle Cloud Infrastructure

Selecionar um intervalo de tempo não padrão para uma consulta

Defina os limites ou timestamps dos dados de métrica que você deseja que sejam retornados de uma consulta de dados de métrica no serviço Monitoring.

Considerações

As opções disponíveis para o intervalo de tempo dependem do intervalo e da resolução.

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

Automático ( páginaMétricas de Serviço)*, quando o período selecionado é 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 é 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

* O intervalo de tempo máximo retornado quando você seleciona Auto para Intervalo (página Métricas de Serviço somente) é determinado pela seleção do intervalo automático. 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 de um minuto e resolução até o horário atual, enviado à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.

  • Por padrão, os gráficos mostram a última hora de dados de métrica. Para obter informações sobre o intervalo de tempo em gráficos padrão, consulte Alterando o Intervalo de Tempo para Gráficos de Métrica Padrão. (O intervalo de tempo não está disponível para o gráfico de métricas exibido durante a criação ou edição de um alarme.)

    1. Crie uma consulta básica na página Metrics Explorer.
    2. Selecione um período em Seleções Rápidas.

      Exemplo de gráfico para Última hora:


      Exemplo de gráfico para seleção de intervalo de tempo de uma hora

      Exemplo de gráfico para Últimas 6 horas:


      Exemplo de gráfico para seleção de intervalo de tempo de seis horas
    3. Para especificar o início ou o fim de um período, clique em Horário inicial ou Horário final e digite um valor.

      Você também pode selecionar a data e a hora na ferramenta de calendário fornecida.


      Ferramenta de calendário fornecida para horas de início e término
  • Observação

    O intervalo de tempo padrão para CLI e API são as últimas três horas.

    Use o comando oci monitoring metric-data summarize-metrics-data e os parâmetros obrigatórios para consultar dados de métrica. Use os parâmetros --start-time e --end-time para selecionar um intervalo de tempo não padrão para a consulta.

    oci monitoring metric-data summarize-metrics-data --start-time <time_rfc3339_format> --end-time <time_rfc3339_format> [...]

    Valor de exemplo para o horário inicial ou final: 2023-09-29T13:58:00.000Z

    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.

  • Observação

    O intervalo de tempo padrão para CLI e API são as últimas três horas.

    Execute a operação SummarizeMetricsData para consultar dados de métrica. Use os atributos startTime e endTime para selecionar um intervalo de tempo não padrão para a consulta. Para obter um exemplo, consulte SummarizeMetricsDataDetails.