Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Invio di registri utilizzando l'endpoint HLC (registri HLC)

L'endpoint HLC Logs () si basa sul formato HTTP Log Collector (HLC/services/collector/event).

Se utilizzi l'autenticazione con token bearer, completa i passaggi di configurazione prima di procedere. Configurazione dell'autenticazione con token al portatore

Modalità di input

Ogni evento è un oggetto JSON con un "event" campo obbligatorio. Campi di metadati opzionali:"time",,"host","source","sourcetype". "index"

Evento singolo:

{"event":"Hello world!","time":1486683865.0}

Matrice di eventi JSON:

[
  {"event":"msg1","time":1486683865.0},
  {"event":"msg2","time":1486683866.0}
]

Eventi concatenati/in batch (nessun array wrapper):

{"event":"msg1","time":1486683865.0}{"event":"msg2","time":1486683866.0}

Campo evento (obbligatorio)

Il "event" campo è obbligatorio. Il suo valore può essere di qualsiasi tipo JSON:

{"event":"a string message"}
{"event":{"message":"structured data","severity":"INFO"}}
{"event":42}
{"event":true}

Gli oggetti senza "event" campo vengono ignorati silenziosamente:

{"message":"this is skipped — no event field"}

Campo orario (opzionale)

Il "time" campo è in secondi epocali (non in millisecondi), con decimali opzionali per una precisione inferiore al secondo.

Content-Type

application/jsonÈ accettata solo.

Tipi di valori JSON accettati

Formato dell'endpoint

L'URL dell'endpoint HLC segue questo formato:

https://logs.<region>.amazonaws.com/services/collector/event?logGroup=<name>&logStream=<name>[&entityName=<name>&entityEnvironment=<environment>]

Parametri richiesti:

Parametri opzionali:

Facoltativamente, è possibile associare gli eventi di registro a un'Serviceentità includendo i seguenti parametri di query. Poiché i log inviati tramite l'endpoint HLC sono telemetria personalizzata, non vengono associati automaticamente a un'entità. Fornendo questi parametri, CloudWatch Logs crea un'entità con KeyAttributes.Type set to Service e la associa ai tuoi eventi di registro. Ciò consente alla funzionalità relativa a Explore di CloudWatch correlare questi log con altri dati di telemetria (metriche, tracce e registri) dello stesso servizio, semplificando la risoluzione dei problemi e il monitoraggio delle applicazioni su diversi tipi di segnale. Per ulteriori informazioni sulle entità e sulla relativa telemetria, vedere Aggiungere informazioni correlate alla telemetria personalizzata.

Formato della richiesta

Invia i log utilizzando HTTP POST con le intestazioni e il testo seguenti:

Intestazioni:

Formato del corpo:

Il corpo della richiesta deve essere in formato JSON con una serie di eventi:

{
    "event": [
        {
            "time": 1730141374.001,
            "event": "Application started successfully",
            "host": "web-server-1",
            "source": "application.log",
            "severity": "info"
        },
        {
            "time": 1730141374.457,
            "event": "User login successful",
            "host": "web-server-1",
            "source": "auth.log",
            "user": "john.doe"
        }
    ]
}

Descrizioni dei campi:

Se necessario, è possibile includere campi personalizzati aggiuntivi.

Richiesta di esempio

curl -X POST "https://logs.<region>.amazonaws.com/services/collector/event?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '{"event":{"message":"User logged in","user_id":"u-123"},"time":1486683865.0,"host":"web-01","source":"auth-service"}'

Best practice

Eventi di raggruppamento

Per prestazioni ed efficienza migliori:

Gestione degli errori

Implementa una corretta gestione degli errori nell'applicazione. Codici di stato HTTP comuni:

Limitazioni