Para recibir y manejar registros de Esadax usando Log Drains, siga los pasos agnósticos de marco a continuación. Estos se aplican a cualquier backend que admita el enrutamiento HTTP y la configuración del entorno.
1. Aplicación. Configurar un punto final
Cree un punto final HTTP (por ejemplo, /esadax/logs) en su aplicación que acepte solicitudes POST. Este punto final recibirá datos de registro de Esadax.
- Asegúrese de que admita cargas útiles JSON.
- Solo acepta solicitudes
POSTpor seguridad y coherencia.
Ejemplo (pseudocódigo):
POST /esadax/logs
Content-Type: application/json
Body: { logs: [...] }
2. Seguridad con verificación de firma
Esadax envía un encabezado de firma (x-esadax-signature) con cada carga útil de registro.
- Establezca un
INTEGRATION_SECRETen su entorno (desde su tablero de Esadax). - Utilice este secreto para verificar la firma y asegurarse de que la solicitud es de Esadax.
Ejemplo de verificación de firma (pseudocódigo estilo Node.js):
const crypto = require('crypto');
function verifySignature(secret, body, signature) {
const hmac = crypto.createHmac('sha256', secret);
hmac.update(body);
const expectedSig = hmac.digest('hex');
return expectedSig === signature;
}
3. Configuración de drenaje de registros en Esadax
En el tablero de Esadax:
- Definir fuentes: Elija las fuentes de registro (por ejemplo,
lambda,edgeostatic). - Seleccionar entornos: Selecciona solo los entornos relevantes (como
productionostaging). - Establecer frecuencia de muestreo: Opcionalmente, limite el volumen del registro (por ejemplo, 50% de frecuencia de muestreo).
4. Asegure la comunicación
- Usar HTTPS: Su punto final de registro debe servirse a través de HTTPS para proteger los datos en tránsito.
- Validar Encabezados e IPs (opcional): Si desea una protección extra, restrinja las solicitudes entrantes a las IPs de Esadax o valide
User-Agent.
Artículo 5. Manejar y almacenar registros
Una vez verificada, analice la carga útil y reenvíela a su herramienta de almacenamiento o análisis de registros preferida (por ejemplo, Datadog, Loki, Sentry, Elasticsearch).
Ejemplo de flujo de manejo de registros:
- Validar → Analizar → Filtrar (opcional) → Almacenar o alertar
Artículo 6. Responda de manera apropiada
Responda siempre a Esadax con el código de estado HTTP correcto:
200 OK: Recibida y verificada correctamente la carga útil400 Bad Request: Datos mal formados o faltantes403 Forbidden: Firma no válida
Artículo 7. Prueba tu configuración
Antes de ir en vivo:
- Use
curlo Postman para enviar cargas útiles simuladas. - Pruebe con firmas válidas e inválidas para verificar su lógica.
- Compruebe los registros y las herramientas de observabilidad para garantizar que los registros se capturen y almacenen correctamente.
Prueba de rizo de ejemplo (Reemplace con su lógica secreta)
curl -X POST https://yourdomain.com/esadax/logs \
-H "Content-Type: application/json" \
-H "x-esadax-signature: <calculated_signature>" \
-d '{ "logs": [...] }'
1. Resumen
| Escalón | Descripción |
|---|---|
| 1 | Crear un extremo de registro seguro |
| 2 | Implementar la verificación de firmas |
| 3 | Configurar drenajes de troncos en Esadax |
| 4 | Usa HTTPS y la validación de IP opcional |
| 5 | Datos de registro de procesos y rutas |
| 6 | Enviar respuestas HTTP adecuadas |
| 7 | Probar la configuración con cargas útiles válidas/inválidas |
