Consultar métricas ativadas do Enhanced Monitoring - : Central de Documentação do Alibaba Cloud

Pré-requisito

A instância deve executar o PostgreSQL.

Para mais informações, consulte Visualizar as métricas do Enhanced Monitoring de uma instância do ApsaraDB RDS for PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDBInstanceMetrics	Operação a ser executada. Defina o valor como DescribeDBInstanceMetrics.
DBInstanceName	String	Sim	pgm-bp1s1j103lo6****	ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
ResourceGroupId	String	Não	rg-acfmy*	ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalRecordCount	Integer	1	Número total de métricas do Enhanced Monitoring ativadas na instância.
RequestId	String	318C3754-F6D0-54BB-A55C-23EAA04708B7	ID da solicitação.
Items	Array of Metrics		Array das métricas do Enhanced Monitoring ativadas na instância.
GroupKey	String	os.cpu_usage	Chave do grupo da métrica do Enhanced Monitoring.
SortRule	Integer	1	Número sequencial da métrica do Enhanced Monitoring.
Description	String	The system CPU utilization. The value of this metric is calculated based on the following formula: System CPU utilization = CPU resources consumed to run kernel code/Total CPU resources.	Descrição da métrica do Enhanced Monitoring.
Unit	String	%	Unidade da métrica do Enhanced Monitoring.
MetricsKey	String	os.cpu_usage.sys.avg	Chave da métrica do Enhanced Monitoring.
GroupKeyType	String	CPU utilization	Nome do grupo da métrica do Enhanced Monitoring.
Method	String	avg	Método de agregação dos dados da métrica do Enhanced Monitoring. Valores válidos: avg: Calcula o valor médio da métrica. min: Calcula o valor mínimo da métrica. max: Calcula o valor máximo da métrica.
Dimension	String	os	Categoria da métrica do Enhanced Monitoring. Valores válidos: os: Métrica do sistema operacional db: Métrica do banco de dados
MetricsKeyAlias	String	os.cpu_usage.sys	Alias da métrica do Enhanced Monitoring.
DBInstanceName	String	rm-bp1*****	ID da instância.

Exemplos

Exemplo de solicitação

http(s)://rds.aliyuncs.com/?Action=DescribeDBInstanceMetrics
&DBInstanceName=pgm-bp1s1j103lo6****
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBInstanceMetrics>
<TotalRecordCount>1</TotalRecordCount>
<RequestId>318C3754-F6D0-54BB-A55C-23EAA04708B7</RequestId>
  <Items>
     <Description>The system CPU utilization. The value of this metric is calculated based on the following formula: System CPU utilization = CPU resources consumed to run kernel code/Total CPU resources.</Description>
     <GroupKeyType>CPU utilization</GroupKeyType>
     <MetricsKey>os.cpu_usage.sys.avg</MetricsKey>
     <GroupKey>os.cpu_usage</GroupKey>
     <Dimension>os</Dimension>
     <Method>avg</Method>
     <Unit>%</Unit>
     <SortRule>1</SortRule>
     <MetricsKeyAlias>os.cpu_usage.sys</MetricsKeyAlias>
  </Items>
</DescribeDBInstanceMetrics>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalRecordCount" : 1,
  "RequestId" : "318C3754-F6D0-54BB-A55C-23EAA04708B7",
  "Items" : {
    "Description": "The system CPU utilization. The value of this metric is calculated based on the following formula: System CPU utilization = CPU resources consumed to run kernel code/Total CPU resources.",
    "GroupKeyType": "CPU utilization",
    "MetricsKey" : "os.cpu_usage.sys.avg",
    "GroupKey" : "os.cpu_usage",
    "Dimension" : "os",
    "Method" : "avg",
    "Unit" : "%",
    "SortRule" : 1,
    "MetricsKeyAlias" : "os.cpu_usage.sys"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceMetricsConfigs.NotFound	The specified instance has no metrics configs	Nenhuma métrica do Enhanced Monitoring está configurada para a instância.
400	InvalidDBInstanceEngineType.Format	the DB instance engine type does not support this operation.	O mecanismo de banco de dados da instância não oferece suporte a esta operação.
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Nome da instância não encontrado. Verifique o nome e tente novamente.

Para obter uma lista de códigos de erro, visite o API Error Center.