Envia vários logs para o Simple Log Service em uma solicitação.
Descrição da operação
Notas de uso
-
As informações necessárias para consultar logs são obtidas. Essas informações incluem o nome do projeto ao qual os logs pertencem, a região do projeto e o nome do Logstore ao qual os logs pertencem. Para mais informações, consulte Gerenciar um projeto e Gerenciar um Logstore.
-
Use esta operação para coletar logs de páginas da web ou clientes.
-
Se você usar o web tracking para coletar logs e não chamar esta operação, poderá enviar apenas um log para o Simple Log Service em uma solicitação. Para mais informações, consulte Usar o web tracking para coletar logs.
-
Se você deseja coletar uma grande quantidade de dados de log, pode chamar esta operação para enviar vários logs para o Simple Log Service em uma solicitação.
-
Antes de chamar esta operação para enviar logs para um Logstore, você deve ativar o web tracking para o Logstore. Para mais informações, consulte Usar o web tracking para coletar logs.
-
Você não pode chamar esta operação para enviar os logs de vários tópicos para o Simple Log Service de uma só vez.
-
Se você chamar esta operação, os usuários anônimos da Internet receberão permissões de gravação no Logstore. Isso pode gerar dados inconsistentes porque a autenticação baseada em par de AccessKey não é realizada.
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
POST /logstores/{logstoreName}/track HTTP/1.1
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| logstoreName |
string |
Sim |
O nome do Logstore. |
ali-test-logstore |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| project |
string |
Sim |
O nome do projeto. |
ali-test-project |
| body |
object |
Sim |
O corpo da solicitação. |
|
| __topic__ |
string |
Não |
O tópico dos logs. |
topic |
| __source__ |
string |
Sim |
A origem dos logs. |
source |
| __logs__ |
array<object> |
Sim |
Os logs. Cada elemento é um objeto JSON que indica um log. Nota
Nota: O horário em um log coletado usando o recurso de web tracking é o horário em que o Simple Log Service recebe o log. Você não precisa configurar o campo __time__ para cada log. Se esse campo existir, ele será substituído pelo horário em que o Simple Log Service recebe o log. |
|
|
object |
Não |
Os logs. |
||
|
string |
Não |
O conteúdo do log. |
{ "key1": "value1", "key2": "value2" } |
|
| __tags__ |
object |
Não |
As tags dos logs. |
|
|
string |
Não |
A tag do log. |
{ "tag1": "value1", "tag2": "value2" } |
Apenas os seguintes cabeçalhos de solicitação são suportados. Os dois primeiros cabeçalhos de solicitação são obrigatórios ao chamar a operação PutWebTracking. Para mais informações sobre os formatos e descrições dos cabeçalhos de solicitação, consulte Cabeçalhos de solicitação comuns.
-
x-log-apiversion: 0.6.0
-
x-log-bodyrawsize: 1234
-
x-log-compresstype: lz4
O cabeçalho x-log-compresstype é obrigatório apenas quando você precisa enviar dados compactados. Para enviar dados compactados, você deve usar o algoritmo LZ4 ou DEFLATE. Você pode especificar x-log-compresstype: lz4 ou x-log-compresstype: deflate. Para mais informações sobre como compactar dados, consulte Compactação de dados.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
Nenhum definido.
Exemplos
Resposta de sucesso
JSON formato
{}
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.