Consulta de logs de consulta lenta
Função
Essa API é usada para consultar os logs de consulta lenta de uma instância de BD especificada. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
POST /v3.1/{project_id}/instances/{instance_id}/slow-logs
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
Explicação: ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. Restrições: Nenhuma Intervalo de valores: O valor pode conter 32 caracteres. Apenas letras e dígitos são permitidos. Valor padrão: Nenhum |
instance_id |
Sim |
String |
Explicação: ID da instância, que identifica exclusivamente uma instância. Restrições: Nenhuma Intervalo de valores: O valor pode conter 36 caracteres com um sufixo de in07. Apenas letras e dígitos são permitidos. Valor padrão: Nenhum |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Explicação: Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token. Restrições: Nenhuma Intervalo de valores: Nenhum Valor padrão: Nenhum |
X-Language |
Não |
String |
Explicação: Tipo de linguagem da solicitação. Restrições: Nenhuma Intervalo de valores:
Valor padrão: en-us |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
node_id |
Sim |
String |
Explicação: ID do nó. Restrições: Nenhuma Intervalo de valores: O valor pode conter 36 caracteres, começando com um UUID e terminando com no07. Apenas letras e dígitos são permitidos. Valor padrão: Nenhum |
start_time |
Sim |
String |
Explicação: Hora de início no formato "aaaa-mm-ddThh:mm:ssZ". T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100. Restrições: Nenhuma Intervalo de valores: A hora é anterior à hora atual. Valor padrão: Nenhum |
end_time |
Sim |
String |
Explicação: Hora de término no formato "aaaa-mm-ddThh:mm:ssZ". T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100. Restrições: Nenhuma Intervalo de valores: A hora é posterior à hora de início e anterior à hora atual. Valor padrão: Nenhum |
limit |
Sim |
Integer |
Explicação: Número de registros a serem consultados. Restrições: Nenhuma Intervalo de valores: 1–5000 Valor padrão: Nenhum |
line_num |
Não |
String |
Explicação: Número de sequência de um evento de log. Este parâmetro não é necessário para a primeira consulta, mas é necessário para consultas de paginação subsequentes. O valor pode ser obtido a partir da resposta da última consulta. Restrições: Nenhuma Intervalo de valores: O valor é uma cadeia de 13 dígitos. Valor padrão: Nenhum |
operate_type |
Não |
String |
Explicação: Tipo de instrução SQL. Restrições: Nenhuma Intervalo de valores: Se esse parâmetro for deixado em branco ou definido como ALL, todos os tipos de instrução serão consultados. Você também pode especificar os seguintes tipos de log:
Valor padrão: Nenhum |
database |
Não |
String |
Explicação: Banco de dados ao qual pertencem os logs de consulta lenta. Restrições: Nenhuma Intervalo de valores: Nenhum Valor padrão: Nenhum |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
slow_log_list |
Array of LtsLogSlowDetail objects |
Explicação: Logs de consulta lenta. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
node_id |
String |
Explicação: ID do nó. Intervalo de valores: O valor pode conter 36 caracteres, começando com um UUID e terminando com no07. Apenas letras e dígitos são permitidos. |
count |
String |
Explicação: Número de execuções. Intervalo de valores: Nenhum |
time |
String |
Explicação: Tempo de execução. Intervalo de valores: Nenhum |
lock_time |
String |
Explicação: Tempo de espera do bloqueio. Intervalo de valores: Nenhum |
rows_sent |
String |
Explicação: Número de linhas enviadas. Intervalo de valores: Nenhum |
rows_examined |
String |
Explicação: Número de linhas verificadas. Intervalo de valores: Nenhum |
database |
String |
Explicação: Banco de dados ao qual pertencem os logs de consulta lenta. Intervalo de valores: gaussdb-mysql |
users |
String |
Explicação: Nome da conta. Intervalo de valores: Nenhum |
query_sample |
String |
Explicação: Sintaxe de execução. Intervalo de valores: Nenhum |
type |
String |
Explicação: Tipo de instrução. Intervalo de valores:
|
start_time |
String |
Explicação: Hora de início no formato UTC. Intervalo de valores: Nenhum |
client_ip |
String |
Explicação: Endereço IP. Intervalo de valores: Nenhum |
line_num |
String |
Explicação: Número de sequência de um evento de log. Intervalo de valores: Nenhum |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitação
Consulta de logs de consulta lenta
POST https://{endpoint}/v3.1/056538411200d4cd2f79c003c7606412/instances/096c0fc43e804757b59946b80dc27f8bin07/slow-logs { "start_time" : "2022-11-20T00:00:00+0800", "end_time" : "2022-11-29T00:00:00+0800", "node_id" : "cc07c60e94ec4575989840e648fb4f66no07", "limit" : 10, "line_num" : 1669344916000 }
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "slow_log_list" : [ { "node_id" : "cc07c60e94ec4575989840e648fb4f66no07", "count" : 1, "time" : "1.04899 s", "lock_time" : "0.00003 s", "rows_sent" : 0, "rows_examined" : 0, "database" : "gaussdb-mysql", "users" : "root", "query_sample" : "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N @time_zone_id);", "type" : "INSERT", "start_time" : "2022-11-25T10:55:16.000", "client_ip" : "192.*.*.1", "line_num" : 1669344916000 } ] }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.