Um Protokolle von Esadax mit Log Drains zu empfangen und zu verarbeiten, führen Sie die folgenden frameworkunabhängigen Schritte aus. Diese gelten für jedes Backend, das HTTP-Routing und Umgebungskonfiguration unterstützt.
1 SGB V. Einrichten eines Endpunkts
Erstellen Sie in Ihrer Anwendung einen HTTP-Endpunkt (z. B. /esadax/logs), der POST-Anforderungen akzeptiert. Dieser Endpunkt erhält Protokolldaten von Esadax.
- Stellen Sie sicher, dass es JSON-Payloads unterstützt.
- Akzeptieren Sie aus Sicherheits- und Konsistenzgründen nur
POST-Anforderungen.
Beispiel (Pseudocode):
POST /esadax/logs
Content-Type: application/json
Body: { logs: [...] }
Zwei. Sicher mit Signaturüberprüfung
Esadax sendet mit jeder Protokoll-Payload einen Signatur-Header (x-esadax-signature).
- Legen Sie einen
INTEGRATION_SECRETin Ihrer Umgebung fest (über Ihr Esadax-Dashboard). - Verwenden Sie dieses Geheimnis, um die Signatur zu überprüfen und sicherzustellen, dass die Anforderung von Esadax stammt.
Beispiel für die Signaturüberprüfung (Pseudocode im Node.js-Stil):
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. Log Drain Konfiguration auf Esadax
Im Esadax Dashboard:
- Quellen definieren: Wählen Sie Protokollquellen aus (z. B.
lambda,edgeoderstatic). - Umgebungen auswählen: Zielen Sie nur relevante Umgebungen an (wie
productionoderstaging). - Abtastrate festlegen: Optionale Begrenzung des Protokollvolumens (z. B. 50 % Abtastrate).
4. Sicherung der Kommunikation
- HTTPS verwenden: Ihr Protokollendpunkt muss über HTTPS bereitgestellt werden, um Daten bei der Übertragung zu schützen.
- Kopfzeilen und IPs validieren (optional): Wenn Sie zusätzlichen Schutz wünschen, beschränken Sie eingehende Anfragen auf Esadax-IPs oder validieren Sie
User-Agent.
Fünf. Protokolle verarbeiten und speichern
Nach der Verifizierung analysieren Sie die Nutzdaten und leiten sie an Ihr bevorzugtes Protokollspeicher- oder Analysetool weiter (z. B. Datadog, Loki, Sentry, Elasticsearch).
Beispiel für die Protokollverarbeitung:
- Validieren → Analysieren → Filtern (optional) → Speichern oder Alarmieren
Sechs. Reagieren Sie angemessen
Antworten Sie Esadax immer mit dem richtigen HTTP-Statuscode:
200 OK: Die Nutzdaten wurden erfolgreich empfangen und verifiziert400 Bad Request: Fehlerhafte oder fehlende Daten403 Forbidden: Ungültige Signatur
Sieben. Testen Sie Ihr Setup
Bevor Sie live gehen:
- Verwenden Sie
curloder Postman, um simulierte Nutzdaten zu senden. - Testen Sie sowohl mit gültigen als auch mit ungültigen Signaturen, um Ihre Logik zu überprüfen.
- Überprüfen Sie Protokolle und Beobachtungstools, um sicherzustellen, dass Protokolle ordnungsgemäß erfasst und gespeichert werden.
Beispiel curl Test (Ersetzen Sie mit Ihrer geheimen Logik)
curl -X POST https://yourdomain.com/esadax/logs \
-H "Content-Type: application/json" \
-H "x-esadax-signature: <calculated_signature>" \
-d '{ "logs": [...] }'
Zusammenfassung
| Step | Beschreibung |
|---|---|
| 1 | Erstellen eines sicheren Protokollendpunkts |
| 2 | Signaturüberprüfung implementieren |
| 3 | Log-Abflüsse in Esadax konfigurieren |
| 4 | HTTPS und optionale IP-Validierung verwenden |
| 5 | Prozess- und Routenprotokolldaten |
| 6 | Richtige HTTP-Antworten senden |
| 7 | Testen Sie das Setup mit gültigen/ungültigen Nutzdaten |
