Recuperar métricas de séries temporais do Insights de Performance - Amazon Relational Database Service

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 Métricas de contador e o gráfico Carregamento do 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 Carregamento 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:

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

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

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

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

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

  • Média: 3

  • Mínimo: 1

  • Máximo: 5

  • Soma: 15

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