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á.

Envio de registros usando o endpoint JSON estruturado (Structured JSON Logs)

O endpoint (/ingest/json) do Structured JSON Logs aceita JSON padrão — um único objeto JSON ou uma matriz JSON de objetos. Esse endpoint foi projetado para dados de log estruturados em que cada evento é um objeto JSON.

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

Só application/json é aceito como o tipo de conteúdo.

Objeto JSON único:

{"timestamp":1771007942000,"message":"single event","level":"INFO"}

Matriz JSON de objetos:

[
  {"timestamp":1771007942000,"message":"event one","level":"INFO"},
  {"timestamp":1771007943000,"message":"event two","level":"ERROR"}
]

Tipos de valores JSON aceitos

Esse endpoint é estrito — somente objetos JSON são aceitos como eventos.

Exemplo — matriz com tipos mistos:

[
  {"timestamp":1771007942000,"message":"valid object"},
  "just a string",
  42,
  {"timestamp":1771007943000,"message":"another valid object"}
]

Resultado: 2 eventos ingeridos (os objetos), 2 ignorados (a string e o número).

Campo de carimbo de data/hora

O "timestamp" campo está em milissegundos de época, o mesmo que o endpoint NDJSON.

Exemplo de solicitação

curl -X POST "https://logs.<region>.amazonaws.com/ingest/json?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '[{"timestamp":1771007942000,"message":"User logged in","user_id":"u-123"},{"timestamp":1771007943000,"message":"Order placed","order_id":"o-456"}]'

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