As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Enviando registros usando o endpoint NDJSON (ND-JSON Logs)

O endpoint ND-JSON Logs (/ingest/bulk) aceita registros no formato NDJSON (Newline Delimited JSON). Cada linha contém exatamente um valor JSON, separado por caracteres de nova linha.

Se você estiver usando a autenticação do token do portador, conclua as etapas de configuração Configurando a autenticação do token do portador antes de continuar.

Formato de solicitação

Envie um valor JSON por linha, separado por \n (LF) ou \r\n (CRLF). As linhas vazias são ignoradas silenciosamente.

{"timestamp":1771007942000,"message":"event one","level":"INFO"}
{"timestamp":1771007943000,"message":"event two","level":"ERROR"}
{"timestamp":1771007944000,"message":"event three","level":"DEBUG"}

Ambos application/json application/x-ndjson são aceitos como o tipo de conteúdo.

Tipos de valores JSON aceitos

De acordo com a especificação NDJSON (RFC 8259), qualquer valor JSON válido é aceito em cada linha.

Objetos JSON (mais comuns):

{"timestamp":1771007942000,"message":"User logged in","service":"auth"}
{"timestamp":1771007943000,"error":"Connection timeout","service":"api"}

Matrizes JSON (agrupadas em eventos individuais):

[{"timestamp":1000,"message":"a"},{"timestamp":2000,"message":"b"}]

Essa única linha produz 2 eventos. Cada elemento da matriz se torna um evento de log separado.

Valores primitivos:

"a plain string log message"
42
true
null

Cada primitivo se torna seu próprio evento com a data e hora atual do servidor.

Tipos mistos:

{"timestamp":1771007942000,"message":"structured event"}
"unstructured string message"
42
{"timestamp":1771007943000,"error":"something failed"}

Todas as 4 linhas são aceitas como eventos válidos.

Campo de carimbo de data/hora

O "timestamp" campo está em milissegundos de época (não segundos).

Linhas inválidas

As linhas que não são JSON válidas são ignoradas e contadas silenciosamente. O processamento continua com a próxima linha.

{"message":"valid event"}
this is not valid json
{"message":"another valid event"}

Resultado: 2 eventos ingeridos, 1 ignorado. Retorna HTTP 200.

Se todas as linhas forem inválidas, retorna HTTP 400 com"All events were invalid".

Exemplo de solicitação

curl -X POST "https://logs.<region>.amazonaws.com/ingest/bulk?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/x-ndjson" \
  -d '{"timestamp":1771007942000,"message":"User logged in","level":"INFO"}
{"timestamp":1771007943000,"message":"Query took 42ms","level":"DEBUG"}
{"timestamp":1771007944000,"error":"Connection refused","level":"ERROR"}'

Respostas

Sucesso (todos os eventos são aceitos):

HTTP 200 OK
{}

Sucesso parcial (alguns eventos foram rejeitados):

{
  "partialSuccess": {
    "rejectedLogRecords": 5,
    "errorMessage": "{\"tooOldLogEventCount\": 3, \"tooNewLogEventCount\": 1, \"expiredLogEventCount\": 1}"
  }
}

O rejectedLogRecords campo é o número total de eventos rejeitados. O errorMessage campo contém um detalhamento codificado em JSON por motivo de rejeição:

Práticas recomendadas

eventos em lotes

Para melhor desempenho e eficiência:

Tratamento de erros

Implemente o tratamento adequado de erros em seu aplicativo. Códigos de status HTTP comuns:

Limitações