Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Envío de registros mediante el punto final de HLC (registros de HLC)

El punto final de HLC Logs (/services/collector/event) se basa en el formato HTTP Log Collector (HLC).

Si utiliza la autenticación mediante token de portador, complete los pasos de configuración antes de continuar. Configuración de la autenticación por token de portador

Modos de entrada

Cada evento es un objeto JSON con un "event" campo obligatorio. Campos de metadatos opcionales:"time","host","source","sourcetype","index".

Evento único:

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

Matriz de eventos JSON:

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

Eventos concatenados o por lotes (sin contenedor de matrices):

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

Campo de evento (obligatorio)

El "event" campo es obligatorio. Su valor puede ser de cualquier tipo de JSON:

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

Los objetos sin un "event" campo se omiten silenciosamente:

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

Campo de tiempo (opcional)

El "time" campo está expresado en segundos de época (no en milisegundos), con decimales opcionales para una precisión inferior a un segundo.

Contenido-Tipo

Solo application/json se acepta.

Tipos de valores JSON aceptados

Formato de punto de conexión

La URL del punto final del HLC sigue este formato:

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

Parámetros necesarios:

Parámetros opcionales:

Si lo desea, puede asociar sus eventos de registro a una Service entidad mediante la inclusión de los siguientes parámetros de consulta. Como los registros enviados a través del punto final del HLC son telemetría personalizada, no se asocian automáticamente a una entidad. Al proporcionar estos parámetros, CloudWatch Logs crea una entidad con KeyAttributes.Type set en Service y la asocia a sus eventos de registro. Esto permite que la función relacionada con Explore CloudWatch correlacione estos registros con otros datos de telemetría (métricas, trazas y registros) del mismo servicio, lo que facilita la resolución de problemas y la supervisión de las aplicaciones en diferentes tipos de señales. Para obtener más información sobre las entidades y la telemetría relacionada, consulte Añadir información relacionada a la telemetría personalizada.

Formato de las solicitudes

Envíe los registros mediante HTTP POST con los siguientes encabezados y cuerpo:

Encabezados:

Formato de cuerpo:

El cuerpo de la solicitud debe estar en formato JSON con una serie de eventos:

{
    "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"
        }
    ]
}

Descripciones de los campos:

Se pueden incluir campos personalizados adicionales según sea necesario.

Ejemplo de solicitud

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"}'

Prácticas recomendadas

Agrupación de eventos por lotes

Para un mejor rendimiento y eficiencia:

Gestión de errores

Implemente una gestión de errores adecuada en su aplicación. Códigos de estado HTTP comunes:

Limitaciones