Recuperar métricas de séries temporais do Insights de Performance - Amazon Aurora

Recuperar métricas de séries temporais do Insights de Performance

A operação GetResourceMetrics recupera uma ou mais métricas de séries temporais dos dados do Performance Insights. GetResourceMetrics requer uma métrica e um período de tempo e retorna uma resposta com uma lista de pontos de dados.

Por exemplo, o AWS Management Console usa GetResourceMetrics para preencher o gráfico Counter Metrics (Métricas de contador) e o gráfico Database Load (Carregamento de banco de dados), como visto na imagem a seguir.

Gráficos Counter Metrics e Database Load

Todas as métricas retornadas por GetResourceMetrics são métricas de séries temporais padrão, com exceção de db.load. Essa métrica é exibida no gráfico Database Load (Carga do banco de dados). A métrica db.load é diferente das outras métricas da série temporal, pois você pode fragmentá-la em subcomponentes chamados de dimensões. Na imagem anterior, db.load é dividido e agrupado pelos estados de espera que compõem o db.load.

nota

GetResourceMetrics também pode retornar a métrica db.sampleload, mas a métrica db.load é apropriada na maioria dos casos.

Para obter informações sobre as métricas de contador retornadas pelo GetResourceMetrics, consulte Métricas de contadores do Performance Insights.

Os cálculos a seguir são compatíveis com as métricas:

  • Average (Média) – o valor médio para a métrica por um período. Adicione .avg ao nome da métrica.

  • Minimum (Mínimo) – o valor mínimo para a métrica por um período. Adicione .min ao nome da métrica.

  • Maximum (Máximo) – o valor máximo para a métrica por um período. Adicione .max ao nome da métrica.

  • Sum (Soma) – a soma dos valores da métrica por um período. Adicione .sum ao nome da métrica.

  • Sample count (Contagem de amostra) – o número de vezes que a métrica foi coletada por um período. Adicione .sample_count ao nome da métrica.

Por exemplo, considere que uma métrica é coletada por 300 segundos (5 minutos) e que a métrica seja coletada uma vez por minuto. Os valores de cada minuto são 1, 2, 3, 4 e 5. Nesse caso, os seguintes cálculos são retornados:

  • Average (Média) – 3

  • Minimum (Mínimo) – 1

  • Maximum (Máximo) – 5

  • Sum (Soma) – 15

  • Sample count (Contagem de amostras) – 5

Para obter informações sobre como usar o comando get-resource-metrics AWS CLI, consulte get-resource-metrics.

Para a opção --metric-queries, especifique uma ou mais consultas para as quais deseja obter resultados. Cada consulta consiste em um parâmetro obrigatório Metric e opcional GroupBy e em parâmetros Filter. Veja a seguir um exemplo de uma especificação de opção --metric-queries.

{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}