Recuperar métricas com a API do Insights de Performance do Amazon RDS - Amazon Relational Database Service

Recuperar métricas com a API do Insights de Performance do Amazon RDS

Quando o Insights de Performance está ativado, a API oferece visibilidade à performance da instância. O Amazon CloudWatch Logs fornece a fonte de autorização para métricas de monitoramento fornecidas para serviços da AWS.

O Performance Insights oferece uma visão específica do domínio da carga do banco de dados medida como sessões ativas médias (AAS). Essa métrica aparece para os consumidores de API como um conjunto de dados bidimensional de séries temporais. A dimensão de tempo dos dados fornece a carga do banco de dados para cada ponto de tempo no intervalo de tempo consultado. Cada ponto de tempo decompõe a carga geral em relação às dimensões solicitadas, como SQL, Wait-event, User ou Host, medidas naquele ponto de tempo.

O Amazon RDS Performance Insights monitora o cluster Amazon RDS da instância de banco de dados , para que você possa analisar e solucionar problemas relacionados à performance do banco de dados. Uma maneira de visualizar os dados do Performance Insights está no AWS Management Console. O Performance Insights também fornece uma API pública para que você possa consultar seus próprios dados. É possível usar a API para fazer o seguinte:

  • Descarregar dados em um banco de dados

  • Adicione dados do Performance Insights aos painéis de monitoramento existentes

  • Criar ferramentas de monitoramento

Para usar a API do Performance Insights, habilite o Performance Insights em uma das suas instâncias de banco de dados do Amazon RDS. Para obter informações sobre como habilitar o Performance Insights, consulte Ativar e desativar o Insights de Performance do Amazon RDS. Para obter mais informações sobre a API do Performance Insights, consulte a Referência de API do Amazon RDS Performance Insights.

A API do Performance Insights fornece as operações a seguir.

Ação do Performance Insights

AWS CLI command

Descrição

CreatePerformanceAnalysisReport

aws pi create-performance-analysis-report

Cria um relatório de análise de performance referente a um período específico para a instância de banco de dados. O resultado é AnalysisReportId, que é o identificador exclusivo do relatório.

DeletePerformanceAnalysisReport

aws pi delete-performance-analysis-report

Exclui um relatório de análise de performance.

DescribeDimensionKeys

aws pi describe-dimension-keys

Recuperar as N principais chaves de dimensão de uma métrica por um período específico.

GetDimensionKeyDetails

aws pi get-dimension-key-details

Recupera os atributos do grupo de dimensões especificado para uma instância de banco de dados ou fonte de dados. Por exemplo, se você especificar um ID SQL e se os detalhes da dimensão estiverem disponíveis, GetDimensionKeyDetails recuperará o texto completo da dimensão db.sql.statement associada a esse ID. Essa operação é útil porque GetResourceMetrics e DescribeDimensionKeys não oferecem suporte à recuperação de texto grande de instrução SQL.

GetPerformanceAnalysisReport

aws pi get-performance-analysis-report

Recupera o relatório, incluindo os insights do relatório. O resultado inclui o status do relatório, o ID do relatório, os detalhes do horário do relatório, os insights e as recomendações.

GetResourceMetadata

aws pi get-resource-metadata

Recupere os metadados para diferentes recursos. Por exemplo, os metadados podem indicar que um recurso está ativado ou desativado em uma instância de banco de dados específica.

GetResourceMetrics

aws pi get-resource-metrics

Recupera as métricas do Performance Insights para um conjunto de fontes de dados, ao longo de um período. É possível fornecer grupos de dimensão e dimensões específicos e fornecer critérios de filtragem e agregação para cada grupo.

ListAvailableResourceDimensions

aws pi list-available-resource-dimensions

Recupere as dimensões que podem ser consultadas para cada tipo de métrica especificado em uma instância especificada.

ListAvailableResourceMetrics

aws pi list-available-resource-metrics

Recupere todas as métricas disponíveis dos tipos de métrica especificados que podem ser consultados para uma instância de banco de dados especificada.

ListPerformanceAnalysisReports

aws pi list-performance-analysis-reports

Recupera todos os relatórios de análise disponíveis para a instância de banco de dados. Os relatórios são listados com base na hora de início de cada relatório.

ListTagsForResource

aws pi list-tags-for-resource

Lista todas as tags de metadados adicionadas ao recurso. A lista inclui o nome e o valor da tag.

TagResource

aws pi tag-resource

Adiciona tags de metadados ao recurso do Amazon RDS. A tag inclui um nome e um valor.

UntagResource

aws pi untag-resource

Remove a tag de metadados do recurso.

Para ter mais informações sobre como recuperar métricas de séries temporais e exemplos da AWS CLI para o Insights de Performance, consulte os tópicos a seguir.