Startseite/Artikel
Esadax JournalCI

Integration von Esadax Log Drains mit jedem Backend

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

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_SECRET in 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, edge oder static).
  • Umgebungen auswählen: Zielen Sie nur relevante Umgebungen an (wie production oder staging).
  • 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 verifiziert
  • 400 Bad Request: Fehlerhafte oder fehlende Daten
  • 403 Forbidden: Ungültige Signatur

Sieben. Testen Sie Ihr Setup

Bevor Sie live gehen:

  • Verwenden Sie curl oder 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

Abonnieren