DescribeSlowLogRecords - Database Autonomy Service: Central de Documentação do Alibaba Cloud

Consulta os registros de log de consultas lentas de uma instância de banco de dados. Você pode filtrar e classificar os resultados por várias condições.

Descrição da operação

InstanceId é o ID da instância. Este parâmetro é obrigatório.
StartTime e EndTime especificam o intervalo de tempo para a consulta. Estes parâmetros são obrigatórios.
Defina PageNumber e PageSize para recuperar os resultados por paginação.
Use o parâmetro OrderBy para classificar os resultados. Para mais informações sobre os campos classificáveis, consulte as Referências.
Use o parâmetro Filters para refinar ainda mais as condições de consulta, como filtrar por endereço de host ou ID de SQL.
Importante Alguns tipos de banco de dados, como PostgreSQL e PolarDB for PostgreSQL, não suportam métodos de classificação específicos. Selecione os parâmetros apropriados com base no seu tipo de banco de dados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hdm:DescribeSlowLogRecords

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	rm-8vbk4xz99su8****
NodeId	string	Não	O ID do nó.	pi-d9j9fe7wq7t9i****
StartTime	integer	Sim	A hora de início.	1596177993000
EndTime	integer	Sim	A hora de término.	1634972640000
PageNumber	integer	Não	O número da página. As páginas começam a partir da página 1.	1
PageSize	integer	Não	O número de entradas por página.	10
Filters	array<object>	Não	A lista de condições de filtro.
	object	Não	A lista de condições de filtro.
Key	string	Não	O parâmetro de filtro. Nota Para mais informações, consulte a descrição suplementar.	Nenhum
Value	string	Não	O valor do parâmetro de filtro.	Nenhum
OrderBy	string	Não	Comum a todos os mecanismos QueryTimeSeconds: duração da consulta (segundos). Timestamp: timestamp. Mecanismos baseados em SQL (MySQL / PolarDB for MySQL / PostgreSQL / PolarDB for PostgreSQL / PolarDB for Oracle / PolarDB-X DN) LockTimeSeconds: tempo de bloqueio (segundos). RowsExamined: linhas examinadas. RowsSent: linhas retornadas. MongoDB KeysExamined: número de índices verificados. DocExamined: número de documentos verificados. ReturnNum: linhas retornadas. SQL Server CPUTimeSeconds: tempo de CPU. IOWrites: número de gravações de I/O. LastRowsCountAffected: últimas linhas afetadas. LogicalIOReads: leituras lógicas de I/O. PhysicalIOReads: leituras físicas de I/O. RowsCountAffected: linhas afetadas. PolarDB-X CN RowsSent: linhas retornadas ou atualizadas. Frows: linhas buscadas. Scnt: número de instruções SQL físicas.	QueryTimeSeconds
Asc	boolean	Não	Especifica se os resultados devem ser classificados em ordem crescente. Valor padrão: true. true: Classifica em ordem crescente. false: Classifica em ordem decrescente.	true

Parâmetros e valores suportados para Key:

ApsaraDB RDS for MySQL, PolarDB for MySQL, ApsaraDB RDS for PostgreSQL e PolarDB for PostgreSQL
- hostAddress: o endereço de origem. Separe múltiplos valores com vírgulas (,).
- sqlId: o ID SQL. Separe múltiplos valores com vírgulas (,).
- user: o nome de usuário. Separe múltiplos valores com vírgulas (,).
- dbName: o nome do banco de dados. Separe múltiplos valores com vírgulas (,).
- tags: as tags. Separe múltiplos valores com vírgulas (,).
MongoDB
- hostInsId: o ID da função. Separe múltiplos valores com vírgulas (,).
- insRole: a função da instância. Separe múltiplos valores com vírgulas (,).
- opType: o tipo de operação. Separe múltiplos valores com vírgulas (,).
- namespace: o namespace. Separe múltiplos valores com vírgulas (,).
- nodeType: o tipo de componente. Separe múltiplos valores com vírgulas (,).
- queryId: o ID da consulta. Separe múltiplos valores com vírgulas (,).
Tair (Redis® OSS-Compatible)
- hostAddress: o endereço de origem.
- user: o nome de usuário.
- dbName: o nome do banco de dados.
- nodeType: o tipo de nó.
ApsaraDB RDS for SQL Server
- hostAddress: o endereço de origem. Separe múltiplos valores com vírgulas (,).
- sqlId: o ID SQL. Separe múltiplos valores com vírgulas (,).
- user: o nome de usuário. Separe múltiplos valores com vírgulas (,).
- dbName: o nome do banco de dados. Separe múltiplos valores com vírgulas (,).
- tags: as tags. Separe múltiplos valores com vírgulas (,).
PolarDB-X
- traceId: o ID de rastreamento da instância.
- role: a função do nó. Valores válidos: CN (nó de computação) e DN (nó de armazenamento). Este parâmetro é obrigatório.
- hostAddress: o endereço de origem. Separe múltiplos valores com vírgulas (,).
- sqlId: o ID SQL. Separe múltiplos valores com vírgulas (,).
- user: o nome de usuário. Separe múltiplos valores com vírgulas (,).
- dbName: o nome do banco de dados. Separe múltiplos valores com vírgulas (,).
- tags: as tags. Separe múltiplos valores com vírgulas (,).

Nota

Os mecanismos SQL suportam a consulta de dados por sqlId. Você pode passar múltiplos valores de sqlId separados por vírgulas (,), até 20.
O MongoDB suporta a consulta de dados por queryId. Você pode passar múltiplos valores de queryId separados por vírgulas (,), até 20.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status retornado.	200
Message	string	A mensagem retornada para a solicitação. Nota Este parâmetro retorna Successful quando a solicitação é bem-sucedida. Se a solicitação falhar, uma mensagem de exceção será retornada, como um código de erro.	Successful
RequestId	string	O ID da solicitação.	A1C79EE2-D04D-571B-8C60-961FAF8E****
Success	string	Indica se a solicitação foi bem-sucedida. true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true
Data	object	DBLogRecords
DbInstanceName	string	O ID da instância.	rm-bp157g54vy772****
NodeId	string	O ID do nó.	node123
ItemsNumbers	integer	O número de itens na lista de logs na página atual.	10
StartTime	string	A hora de início.	1672531200000
EndTime	string	A hora de término.	1672617600000
DbInstanceId	integer	O ID numérico da instância.	100
TotalRecords	integer	O número total de registros.	100
PageNumbers	integer	O número da página para a consulta paginada. O valor começa em 1. Valor padrão: 1.	1
MaxRecordsPerPage	integer	O número máximo de registros por página para a consulta paginada. Valores válidos: 5 a 100.	20
Logs	array<object>	Os dados retornados.
	array<object>	Os dados retornados.
SqlId	string	O ID do modelo SQL.	sqlId
Scheme	string	O esquema de dados.	HTTPS
SubInstanceId	string	O ID da subinstância.	r-8vb219d10038****
DbInstanceName	string	O ID da instância.	rm-2zebg30mk056g****
InsName	string	O nome da instância.	test
AccountName	string	O nome de usuário.	user1
HostAddress	string	O endereço de origem.	192.168.1.1
QueryStartTime	string	A hora em que a consulta começou. Formato: yyyy-MM-dd hh:mm:ss (UTC).	2024-04-01 11:00:00
SQLText	string	O texto SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
Psql	string	O modelo SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
DBName	string	O nome do banco de dados.	test
QueryTime	integer	A duração da consulta.	121
ReturnItemNumbers	string	O número de itens retornados.	test
DocsExamined	string	O número de documentos examinados durante a operação do MongoDB.	100
KeysExamined	string	O número de linhas de índice examinadas no MongoDB.	valueA
TableName	string	O nome da tabela.	tableNameExample
LockTime	number	O tempo de espera de bloqueio.	100
RowsExamined	integer	O número de linhas examinadas.	100
RowsSent	integer	O número de linhas retornadas.	10
ThreadId	string	O ID da thread.	57472578
Timestamp	integer	O timestamp.	1747118812
SqlTag	object	A tag.
SqlId	string	O sqlid.	8ad7069f236bcdaaa9b3ae4b6299****
Tags	string	Múltiplas tags separadas por vírgulas.	DAS_IMPORTANT,DAS_IN_PLAN
Comments	string	Os comentários.	test
LockTimeSeconds	number	O tempo de espera de bloqueio, em segundos.	100
QueryTimeSeconds	number	A duração da consulta, em segundos.	100
SqlType	string	O tipo de instrução SQL. Valores válidos: SELECT UPDATE DELETE	SELECT
CPUTime	number	O tempo de consulta da CPU. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	50
IOWrites	integer	O número de gravações de E/S. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	1
LastRowsCountAffected	integer	O número de linhas afetadas pela última instrução. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	10
LogicalIOReads	integer	O número de leituras lógicas. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	1
PhysicalIOReads	integer	O número de leituras físicas. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	1
RowsCountAffected	integer	O número de linhas afetadas. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	10
Command	string	A instrução de consulta lenta. Nota Apenas instâncias de banco de dados ApsaraDB Tair (Redis® OSS-Compatible) são suportadas.	GET async_c4d163675f44fe83f6214cf9ba5exxxx
Namespace	string	O namespace. Nota Apenas instâncias do ApsaraDB for MongoDB são suportadas.	app.event
QueryId	string	O ID da consulta. Nota Apenas instâncias do ApsaraDB for MongoDB são suportadas.	d236d0c4ae8485f6ffe5fdbe5e1bdxxx
ReturnNum	string	O número de linhas retornadas. Nota Apenas instâncias do ApsaraDB for MongoDB são suportadas.	20
ApplicationName	string	O nome do aplicativo. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	MyApp
CPUTimeSeconds	number	O tempo de consulta da CPU, em segundos. Nota Apenas instâncias do ApsaraDB RDS for SQL Server são suportadas.	100
Rows	integer	O número total de linhas atualizadas ou retornadas pelos nós de computação da instância de banco de dados PolarDB-X 2.0. Nota Apenas instâncias de banco de dados ApsaraDB PolarDB-X 2.0 são suportadas.	20
Frows	integer	O número de linhas buscadas pelo nó de computação (CN) do banco de dados PolarDB-X 2.0. Nota Apenas instâncias de banco de dados ApsaraDB PolarDB-X 2.0 são suportadas.	10
Scnt	integer	O número de solicitações do nó de dados (DN) a partir do nó de computação (CN) do banco de dados PolarDB-X 2.0. Nota Apenas instâncias de banco de dados ApsaraDB PolarDB-X 2.0 são suportadas.	10
TraceId	string	O ID de rastreamento do PolarDB-X 2.0, que é o ID de execução da instrução SQL no nó de dados do banco de dados. Nota Apenas instâncias de banco de dados ApsaraDB PolarDB-X 2.0 são suportadas.	074ce334-5247-40b9-b0c1-158aea5d****
TemplateId	string	O ID do modelo do banco de dados PolarDB-X 2.0. Nota Apenas instâncias de banco de dados ApsaraDB PolarDB-X 2.0 são suportadas.	6a63b6ac4572abfaef7d1163f684****
NodeId	string	O ID do nó.	r-uf6cfc5e1xxx-proxy-11
Cmd	string	O comando executado na camada de proxy do Redis.	GET
Rt	integer	O tempo total de resposta na camada de proxy do Redis, em microssegundos.	2055
RequestSize	integer	O tamanho do pacote de solicitação na camada de proxy do Redis, em bytes.	58
ResponseSize	integer	O tamanho do pacote de resposta na camada de proxy do Redis, em bytes.	1535916
ClientIp	string	O endereço IP do cliente conectado ao proxy do Redis.	172.16.15.204
DbId	string	O DbId do proxy do Redis.	r-uf6cfc5e1bcb1xxx-db-5
OriginTime	string	O tempo de execução no proxy do Redis.	2026-09-18 10:54:55.311
OpType	string	O tipo de operação. Nota Apenas instâncias do ApsaraDB for MongoDB são suportadas.	getMore
Fail	string	Indica se a execução SQL foi bem-sucedida. 0 indica sucesso. Um valor diferente de zero indica falha. Nota Apenas instâncias do ApsaraDB for Lindorm são suportadas.	1
Params	string	Os valores de parâmetro anexados à instrução SQL em cenários de consulta de parâmetros. Múltiplos parâmetros são separados por vírgulas (,). Nota Apenas instâncias de banco de dados ApsaraDB for Lindorm são suportadas.
Reason	string	A mensagem de erro quando a execução da consulta lenta falha. Nota Apenas instâncias do ApsaraDB for Lindorm são suportadas.	create-by-mse-can-not-delete
ReqId	string	O identificador exclusivo do registro de log de consulta lenta. Nota Apenas instâncias do ApsaraDB for Lindorm são suportadas.	hotspot-request-001
ExtText	string	O campo de extensão que contém informações adicionais sobre a execução SQL. Nota Apenas instâncias do PolarDB for MySQL são suportadas.

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "A1C79EE2-D04D-571B-8C60-961FAF8E****",
  "Success": "true",
  "Data": {
    "DbInstanceName": "rm-bp157g54vy772****",
    "NodeId": "node123",
    "ItemsNumbers": 10,
    "StartTime": "1672531200000",
    "EndTime": "1672617600000",
    "DbInstanceId": 100,
    "TotalRecords": 100,
    "PageNumbers": 1,
    "MaxRecordsPerPage": 20,
    "Logs": [
      {
        "SqlId": "sqlId",
        "Scheme": "HTTPS",
        "SubInstanceId": "r-8vb219d10038****",
        "DbInstanceName": "rm-2zebg30mk056g****",
        "InsName": "test",
        "AccountName": "user1",
        "HostAddress": "192.168.1.1",
        "QueryStartTime": "2024-04-01 11:00:00",
        "SQLText": "SELECT * FROM my_table WHERE ROWNUM <= 10",
        "Psql": "SELECT * FROM my_table WHERE ROWNUM <= 10",
        "DBName": "test",
        "QueryTime": 121,
        "ReturnItemNumbers": "test",
        "DocsExamined": "100",
        "KeysExamined": "valueA",
        "TableName": "tableNameExample",
        "LockTime": 100,
        "RowsExamined": 100,
        "RowsSent": 10,
        "ThreadId": "57472578",
        "Timestamp": 1747118812,
        "SqlTag": {
          "SqlId": "8ad7069f236bcdaaa9b3ae4b6299****",
          "Tags": "DAS_IMPORTANT,DAS_IN_PLAN",
          "Comments": "test"
        },
        "LockTimeSeconds": 100,
        "QueryTimeSeconds": 100,
        "SqlType": "SELECT",
        "CPUTime": 50,
        "IOWrites": 1,
        "LastRowsCountAffected": 10,
        "LogicalIOReads": 1,
        "PhysicalIOReads": 1,
        "RowsCountAffected": 10,
        "Command": "SELECT",
        "Namespace": "pro-test",
        "QueryId": "sq-1pzcdMwRb",
        "ReturnNum": "20",
        "ApplicationName": "MyApp",
        "CPUTimeSeconds": 100,
        "Rows": 20,
        "Frows": 10,
        "Scnt": 10,
        "TraceId": "074ce334-5247-40b9-b0c1-158aea5d****",
        "TemplateId": "6a63b6ac4572abfaef7d1163f684****",
        "NodeId": "r-uf6cfc5e1xxx-proxy-11",
        "Cmd": "GET",
        "Rt": 2055,
        "RequestSize": 58,
        "ResponseSize": 1535916,
        "ClientIp": "172.16.15.204",
        "DbId": "r-uf6cfc5e1bcb1xxx-db-5",
        "OriginTime": "2026-09-18 10:54:55.311",
        "OpType": "getMore",
        "Fail": "1",
        "Params": "",
        "Reason": "create-by-mse-can-not-delete",
        "ReqId": "hotspot-request-001",
        "ExtText": ""
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The request parameters are invalid.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.