Consulta del rendimiento del proxy de base de datos - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeDBProxyPerformance para consultar las métricas de rendimiento del proxy de base de datos de una instancia de ApsaraDB RDS.

Antes de llamar a la operación DescribeDBProxyPerformance, asegúrese de haber llamado a la operación ModifyDBProxy para habilitar la función de proxy de base de datos en la instancia.

La función de proxy dedicado de ApsaraDB RDS for MySQL ofrece capacidades como la división de lectura/escritura y la optimización de conexiones de corta duración. Para obtener más información, consulte ¿Qué son los proxies de base de datos?
La función de proxy de base de datos de ApsaraDB RDS for PostgreSQL admite la división de lectura/escritura. Para obtener más información, consulte ¿Qué son los proxies de base de datos?

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeDBProxyPerformance	La operación que desea ejecutar. Establezca el valor en DescribeDBProxyPerformance.
DBInstanceId	String	Sí	rm-t4n3axxxxx	El ID de la instancia. Puede llamar a la operación DescribeDBInstances para consultar el ID de la instancia.
DBProxyInstanceType	String	No	DedicatedProxy	El tipo de proxy habilitado en la instancia. Establezca el valor en DedicatedProxy.
StartTime	String	Sí	2019-09-19T01:00:00Z	El inicio del intervalo de tiempo a consultar. Especifique la hora según el estándar ISO 8601 con el formato aaaa-MM-ddTHH:mm:ssZ. La hora debe estar en formato UTC.
EndTime	String	Sí	2019-09-21T18:00:00Z	El final del intervalo de tiempo a consultar. La hora de finalización debe ser posterior a la hora de inicio. Especifique la hora según el estándar ISO 8601 con el formato aaaa-MM-ddTHH:mm:ssZ. La hora debe estar en formato UTC.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde reside la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
MetricsName	String	Sí	Maxscale_CpuUsage	Las métricas de rendimiento que desea consultar. Si la instancia ejecuta MySQL, solo puede consultar la métrica de rendimiento Maxscale_CpuUsage, que indica la utilización de CPU de la instancia. Si la instancia ejecuta PostgreSQL, puede consultar las siguientes métricas de rendimiento: Maxscale_TotalConns: número de conexiones por segundo Maxscale_CurrentConns: número de conexiones establecidas Maxscale_DownFlows: tráfico saliente Maxscale_UpFlows: tráfico entrante Maxscale_QPS: QPS Maxscale_MemUsage: uso de memoria Maxscale_CpuUsage: utilización de CPU Para consultar más de una métrica de rendimiento, sepárelas con comas (,). Puede especificar hasta seis métricas de rendimiento en una sola solicitud.
DBProxyEngineType	String	No	normal	Parámetro interno. No es necesario especificar este parámetro.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
EndTime	String	2019-09-21T18:00:00Z	El final del intervalo de tiempo consultado.
StartTime	String	2019-09-19T01:00:00Z	El inicio del intervalo de tiempo consultado.
DBInstanceId	String	lsmexxxxxxx	El ID de la instancia.
RequestId	String	DD31056F-A0CE-41D7-AD39-689B6ABAE982	El ID de la solicitud.
DBProxyEngineType	String	normal	Parámetro interno. No es necesario especificar este parámetro.
PerformanceKeys	Array of PerformanceKey		Matriz que contiene las métricas de rendimiento devueltas.
PerformanceKey
ValueFormat	String	docker_container_cpu	El formato en el que se devuelve el valor de la métrica de rendimiento.
Key	String	cpu_ratio	El nombre de la métrica de rendimiento.
Values	Array of PerformanceValue		Matriz que contiene los valores de la métrica de rendimiento con el siguiente formato: {valor1, valor2, ...}.
PerformanceValue
Date	String	2019-10-10T09:00:00Z	La hora en que se registró el valor de la métrica de rendimiento. La hora sigue el estándar ISO 8601 con el formato aaaa-MM-dd T HH:mm:ss Z. La hora se muestra en formato UTC.
Value	String	2.83	El valor de la métrica de rendimiento.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	El mensaje de error devuelto porque no se encuentra el nombre de la instancia.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	El mensaje de error devuelto porque el valor del parámetro DBInstanceName no es válido. Compruebe si el valor es nulo o una cadena vacía.
404	Endpoint.NotFound	Specified endpoint is not found.	El mensaje de error devuelto porque no se encuentra el número de puerto especificado.

Para obtener una lista de códigos de error, visite el Centro de errores de API.