Todos os produtos
Search
Central de documentação

:Consultar métricas de monitoramento aprimorado disponíveis

Última atualização: Jun 26, 2026

Chame a operação DescribeAvailableMetrics para consultar as métricas de monitoramento aprimorado disponíveis para uma instância ApsaraDB RDS for PostgreSQL.

Pré-requisitos

Antes de chamar esta operação, verifique se a instância executa PostgreSQL.

Para mais informações, consulte Visualize as métricas de monitoramento aprimorado de uma instância ApsaraDB RDS for PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter

Type

Required

Example

Description

Action

String

Yes

DescribeAvailableMetrics

The operation that you want to perform. Defina the value to DescribeAvailableMetrics.

DBInstanceName

String

Yes

pgm-bp1s1j103lo6****

The ID of the instance. You can call the DescribeDBInstances operation to query the ID of the instance.

ResourceGroupId

String

No

rg-acfmy*

The ID of the resource group to which the instance belongs.

Parâmetros de resposta

Parameter Type Example Description
TotalRecordCount Integer 4

O número total de métricas de monitoramento aprimorado disponíveis para a instância.

RequestId String 5CD61041-35F7-10F7-BE94-33A48B221218

O ID da requisição.

Items Array of Metrics

Detalhes da métrica de monitoramento aprimorado.

GroupKey String os.cpu_usage

A chave do grupo ao qual a métrica de monitoramento aprimorado pertence.

SortRule Integer 1

O número de série da métrica de monitoramento aprimorado.

Description String OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs

A descrição da métrica de monitoramento aprimorado.

Unit String %

A unidade da métrica de monitoramento aprimorado.

MetricsKey String os.cpu_usage.sys.avg

A chave da métrica de monitoramento aprimorado.

GroupKeyType String CPU utilization

O nome do grupo ao qual a métrica de monitoramento aprimorado pertence.

MetricsKeyAlias String cpu_sys_per_core

O alias da métrica de monitoramento aprimorado.

Method String avg

O método de agregação dos dados de monitoramento da métrica de monitoramento aprimorado. Valores válidos:

  • avg: O sistema calcula o valor médio da métrica de monitoramento aprimorado.
  • min: O sistema calcula o valor mínimo da métrica de monitoramento aprimorado.
  • max: O sistema calcula o valor máximo da métrica de monitoramento aprimorado.
Dimension String os

A categoria da métrica de monitoramento aprimorado. Valores válidos:

  • os: métrica de SO
  • db: métrica de banco de dados
DBInstanceName String rm-bp1*****

O ID da instância.

Exemplos

Exemplos de requisição

http(s)://rds.aliyun.cs/?Action=DescribeAvailableMetrics
&DBInstanceName=pgm-bp1s1j103lo6****
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

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

<DescribeAvailableMetricsResponse>
<TotalRecordCount>2</TotalRecordCount>
<RequestId>A467D279-68A8-57B3-BDA4-35F8B3DDB1B7</RequestId>
<Items>
    <Description>OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs</Description>
    <MetricsKey>os.cpu_usage.sys.avg</MetricsKey>
    <GroupKeyType>CPU utilization</GroupKeyType>
    <GroupKey>os.cpu_usage</GroupKey>
    <Method>avg</Method>
    <Dimension>os</Dimension>
    <Unit>%</Unit>
    <SortRule>1</SortRule>
    <DbType>pgsql</DbType>
    <MetricsKeyAlias>os.cpu_usage.sys</MetricsKeyAlias>
</Items>
<Items>
    <Description>User CPU utilization, equal to the number of user-consumed CPUs divided by the total number of CPUs</Description>
    <MetricsKey>os.cpu_usage.user.avg</MetricsKey>
    <GroupKeyType>CPU utilization</GroupKeyType>
    <GroupKey>os.cpu_usage</GroupKey>
    <Method>avg</Method>
    <Dimension>os</Dimension>
    <Unit>%</Unit>
    <SortRule>2</SortRule>
    <DbType>pgsql</DbType>
    <MetricsKeyAlias>os.cpu_usage.user</MetricsKeyAlias>
</Items>
</DescribeAvailableMetricsResponse>

JSON format

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

{
  "TotalRecordCount" : 2,
  "RequestId" : "A467D279-68A8-57B3-BDA4-35F8B3DDB1B7",
  "Items" : [ {
    "Description": "OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs",
    "MetricsKey" : "os.cpu_usage.sys.avg",
    "GroupKeyType": "CPU utilization",
    "GroupKey" : "os.cpu_usage",
    "Method" : "avg",
    "Dimension" : "os",
    "Unit" : "%",
    "SortRule" : 1,
    "DbType" : "pgsql",
    "MetricsKeyAlias" : "os.cpu_usage.sys"
  }, {
    "Description": "User CPU utilization, equal to the number of user-consumed CPUs divided by the total number of CPUs",
    "MetricsKey" : "os.cpu_usage.user.avg",
    "GroupKeyType": "CPU utilization",
    "GroupKey" : "os.cpu_usage",
    "Method" : "avg",
    "Dimension" : "os",
    "Unit" : "%",
    "SortRule" : 2,
    "DbType" : "pgsql",
    "MetricsKeyAlias" : "os.cpu_usage.user"
  } ]
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

InvalidDBInstanceEngineType.Format

the DB instance engine type does not support this operation.

O erro indica que a operação não é compatível com o mecanismo de banco de dados da instância.

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

O erro indica que o nome da instância não foi encontrado. Verifique o nome da instância e tente novamente.

Para obter uma lista de códigos de erro, acesse a API Error Center.