Selecionando uma Resolução Não Padrão para uma Consulta
Especifique um valor não padrão de resolução para consultar dados de métrica no serviço Monitoring.
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
.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.
Para solucionar problemas de consulta, veja 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.
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.
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 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.