Consulta logs em um projeto. Você pode usar esta operação para consultar logs no nível do projeto.
Descrição da operação
Notas de uso
-
Host consiste em um nome de projeto e um endpoint do Simple Log Service. Você deve especificar um projeto em Host.
-
Um par de AccessKey foi criado e obtido. Para mais informações, consulte Par de AccessKey.
O par de AccessKey de uma conta Alibaba Cloud possui permissões em todas as operações de API. Usar essas credenciais para realizar operações no Simple Log Service é uma operação de alto risco. Recomendamos que você use um usuário Resource Access Management (RAM) para chamar operações de API ou realizar O&M de rotina. Para criar um usuário RAM, faça login no console do RAM. Certifique-se de que o usuário RAM tenha as permissões de gerenciamento nos recursos do Simple Log Service. Para mais informações, consulte Criar um usuário RAM e autorizar o usuário RAM a acessar o Simple Log Service.
-
As informações necessárias para consultar logs foram obtidas. As informações incluem o nome do projeto ao qual os logs pertencem e a região do projeto. Para mais informações, consulte Gerenciar um projeto.
-
Os índices são configurados antes de você consultar logs. Para mais informações, consulte Criar índices.
-
Limites são impostos quando você usa o Simple Log Service para consultar logs. Recomendamos que você especifique instruções de consulta e intervalos de tempo de consulta com base nos limites. Para mais informações, consulte Visão geral da pesquisa de logs e Visão geral da análise de logs.
-
Você deve definir query como uma instrução SQL padrão.
-
Você deve especificar um Logstore na cláusula FROM de uma instrução SQL. Um Logstore pode ser usado como uma tabela SQL.
-
Você deve especificar um intervalo de tempo em uma instrução SQL usando o parâmetro __date__ ou __time__. O valor do parâmetro __date__ é um timestamp. O valor do parâmetro __time__ é um inteiro, e a unidade do valor é segundos.
Recursos de autenticação
A tabela a seguir descreve as informações de autorização necessárias para esta operação. Você pode adicionar as informações ao elemento Action de uma declaração de política RAM para conceder a um usuário RAM ou a uma função RAM as permissões para chamar esta operação.
| Action | Resource |
log:GetProjectLogs | acs:log:{#regionId}:{#accountId}:project/{#ProjectName} |
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
GET /logs HTTP/1.1
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| project |
string |
Sim |
O nome do projeto. |
ali-test-project |
| query |
string |
Sim |
A instrução SQL padrão. Neste exemplo, a instrução SQL consulta o número de visualizações de página (PVs) de 2022-03-01 10:41:40 a 2022-03-01 10:56:40 em um Logstore cujo nome é nginx-moni. |
SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400 |
| powerSql |
boolean |
Não |
Especifica se o recurso Dedicated SQL deve ser ativado. Para mais informações, consulte Ativar Dedicated SQL. Valores válidos:
Você pode usar o parâmetro powerSql ou query para configurar o Dedicated SQL. |
false |
Exemplos de solicitações
GET /logs?query=SELECT COUNT(*) as pv FROM nginx-moni where time > 1646102500 and time < 1646103400&powerSql=false HTTP/1.1 Host:ali-test-project.ch-hangzhou.log.aliyuncs.com Content-Type:application/json.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
array |
Os logs retornados. |
||
|
object |
O log retornado. |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
|
|
string |
O log retornado. |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
Exemplos
Resposta de sucesso
JSON formato
[
{
"key": "[ { \"__time__\" : 1409529660, \"__source__\" : \"192.168.1.100\", \"Key1\" : \"error\", \"Key2\" : \"Value2\" }, { \"__time__\" : 1409529680, \"__source__\" : \"192.168.1.100\", \"Key3\" : \"error\", \"Key4\" : \"Value4\" } ]"
}
]
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.