Selecionando uma Faixa 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.
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.
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.)
- Observação
O intervalo de tempo padrão da CLI e da 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 uma faixa de tempo não default 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 CLI, consulte a Referência de Linha de Comandos para Monitoramento.
- Observação
O intervalo de tempo padrão da CLI e da API são as últimas três horas.Execute a operação SummarizeMetricsData para consultar dados de métrica. Use os atributos
startTime
eendTime
para selecionar uma faixa de tempo não default para a consulta. Para obter um exemplo, consulte SummarizeMetricsDataDetails.