Consultar desempenho do proxy de banco de dados - : Central de Documentação do Alibaba Cloud

Antes de chamar a operação DescribeDBProxyPerformance, verifique se a operação ModifyDBProxy foi chamada para ative o recurso de proxy de banco de dados na instância.

O recurso de proxy dedicado do ApsaraDB RDS for MySQL oferece funcionalidades como divisão de leitura e escrita e otimização de conexões de curta duração. Para mais informações, consulte O que são proxies de banco de dados?
O recurso de proxy de banco de dados do ApsaraDB RDS for PostgreSQL oferece suporte à divisão de leitura e escrita. Para mais informações, consulte O que são proxies de banco de dados?

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDBProxyPerformance	Operação a ser executada. Defina o valor como DescribeDBProxyPerformance.
DBInstanceId	String	Sim	rm-t4n3axxxxx	ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
DBProxyInstanceType	String	Não	DedicatedProxy	Tipo de proxy ativado na instância. Defina o valor como DedicatedProxy.
StartTime	String	Sim	2019-09-19T01:00:00Z	Início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601, no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
EndTime	String	Sim	2019-09-21T18:00:00Z	Fim do intervalo de tempo a ser consultado. O horário final deve ser posterior ao inicial. Especifique a hora no padrão ISO 8601, no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
RegionId	String	Sim	cn-hangzhou	ID da região onde a instância está localizada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
MetricsName	String	Sim	Maxscale_CpuUsage	Métricas de desempenho a serem consultadas. Se a instância executar MySQL, será possível consultar apenas a métrica Maxscale_CpuUsage, que indica a utilização da CPU da instância. Caso a instância execute PostgreSQL, as seguintes métricas estarão disponíveis para consulta: Maxscale_TotalConns: número de conexões por segundo Maxscale_CurrentConns: quantidade de conexões estabelecidas Maxscale_DownFlows: tráfego de saída Maxscale_UpFlows: tráfego de entrada Maxscale_QPS: QPS Maxscale_MemUsage: uso de memória Maxscale_CpuUsage: utilização da CPU Para consultar mais de uma métrica, separe-as por vírgulas (,). É possível especifique até seis métricas em uma única solicitação.
DBProxyEngineType	String	Não	normal	Parâmetro interno. Não é necessário especifique este parâmetro.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
EndTime	String	2019-09-21T18:00:00Z	Fim do intervalo de tempo consultado.
StartTime	String	2019-09-19T01:00:00Z	Início do intervalo de tempo consultado.
DBInstanceId	String	lsmexxxxxxx	ID da instância.
RequestId	String	DD31056F-A0CE-41D7-AD39-689B6ABAE982	ID da solicitação.
DBProxyEngineType	String	normal	Parâmetro interno. Não é necessário especifique este parâmetro.
PerformanceKeys	Array of PerformanceKey		Array composto pelas métricas de desempenho retornadas.
PerformanceKey
ValueFormat	String	docker_container_cpu	Formato no qual o valor da métrica de desempenho é retornado.
Key	String	cpu_ratio	Nome da métrica de desempenho.
Values	Array of PerformanceValue		Array composto pelos valores da métrica de desempenho no seguinte formato: {valor1, valor2, ...}.
PerformanceValue
Date	String	2019-10-10T09:00:00Z	Momento em que o valor da métrica de desempenho foi registrado. A hora segue o padrão ISO 8601 no formato aaaa-MM-dd T HH:mm:ss Z e é exibida em UTC.
Value	String	2.83	Valor da métrica de desempenho.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeDBProxyPerformance
&RegionId=cn-hangzhou
&DBInstanceId=rm-t4n3axxxxx
&MetricsName=Maxscale_CpuUsage
&StartTime=2019-09-19T01:00:00Z
&EndTime=2019-09-21T18:00:00Z
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeDBProxyPerformanceResponse>
<DBInstanceId>lsmexxxxxxx</DBInstanceId>
<RequestId>DD31056F-A0CE-41D7-AD39-689B6ABAE982</RequestId>
<PerformanceKeys>
    <PerformanceKey>
        <Values>
            <PerformanceValue>
                <Value>2.83</Value>
                <Date>2019-10-10T09:00:00Z</Date>
            </PerformanceValue>
        </Values>
        <Key>cpu_ratio</Key>
        <ValueFormat>docker_container_cpu</ValueFormat>
    </PerformanceKey>
</PerformanceKeys>
<EndTime>2019-10-10T09:39:28Z</EndTime>
<StartTime>2019-10-01T09:39:28Z</StartTime>
</DescribeDBProxyPerformanceResponse>

Formato JSON

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

{
  "DBInstanceId" : "lsmexxxxxxx",
  "RequestId" : "DD31056F-A0CE-41D7-AD39-689B6ABAE982",
  "PerformanceKeys" : {
    "PerformanceKey" : [ {
      "Values" : {
        "PerformanceValue" : [ {
          "Value" : "2.83",
          "Date" : "2019-10-10T09:00:00Z"
        } ]
      },
      "Key" : "cpu_ratio",
      "ValueFormat" : "docker_container_cpu"
    } ]
  },
  "EndTime" : "2019-10-10T09:39:28Z",
  "StartTime" : "2019-10-01T09:39:28Z"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	Mensagem de erro retornada porque o nome da instância não foi encontrado.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	Mensagem de erro retornada porque o valor do parâmetro DBInstanceName é inválido. Verifique se o valor é nulo ou uma string vazia.
404	Endpoint.NotFound	Specified endpoint is not found.	Mensagem de erro retornada porque o endpoint especificado não foi encontrado.

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