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.