Etusivu/Artikkeli
Esadax JournalCI

Esadax Log Drainsin integrointi mihin tahansa taustajärjestelmään

Jos haluat vastaanottaa ja käsitellä lokeja Esadaxista käyttämällä Log Drains -ohjelmaa, noudata alla olevia kehyksestä riippumattomia ohjeita. Nämä koskevat mitä tahansa taustajärjestelmää, joka tukee HTTP-reitityksen ja ympäristön määrittämistä. 1. vaihe. Määritä

Jos haluat vastaanottaa ja käsitellä lokeja Esadaxista käyttämällä Log Drains -ohjelmaa, noudata alla olevia kehyksestä riippumattomia ohjeita. Nämä koskevat mitä tahansa taustajärjestelmää, joka tukee HTTP-reitityksen ja ympäristön määrittämistä.


1. vaihe. Määritä päätepiste

Luo sovellukseen HTTP-päätepiste (esim. /esadax/logs), joka hyväksyy POST-pyynnöt. Tämä päätelaite vastaanottaa lokitiedot Esadaxista.

  • Varmista, että se tukee JSON-hyötykuormia.
  • Hyväksy vain POST-pyynnöt tietoturvan ja johdonmukaisuuden vuoksi.

Esimerkki (pseudokoodi):

POST /esadax/logs
Content-Type: application/json
Body: { logs: [...] }

- Kaksi. Turvallista allekirjoituksen varmennuksella

Esadax lähettää allekirjoituksen otsikon (x-esadax-signature) jokaisen lokin hyötykuorman kanssa.

  • Aseta INTEGRATION_SECRET ympäristössäsi (Esadaxin kojelaudasta).
  • Tämän salaisuuden avulla voit tarkistaa allekirjoituksen ja varmistaa, että pyyntö on peräisin Esadaxista.

Allekirjoituksen tarkistusesimerkki (Node.js-tyylinen pseudokoodi):

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;
}

Kolme. Loki tyhjennys kokoonpano Esadax

Esadaxin hallintapaneelissa:

  • Määritä lähteet: Valitse lokilähteet (esim. lambda, edge tai static).
  • Valitse ympäristöt: Kohdista vain asiaankuuluvat ympäristöt (kuten production tai staging).
  • Aseta näytteenottotaajuus: Voit halutessasi rajoittaa lokin äänenvoimakkuutta (esim. 50% näytteenottotaajuus).

- Neljä. Suojaa viestintä

  • Käytä HTTPS-protokollaa: Lokin päätepisteen on oltava HTTPS-protokollaa käyttävä, jotta siirrettävät tiedot suojataan.
  • Validate Headers and IPs (valinnainen): Jos haluat lisäsuojaa, rajoita saapuvat pyynnöt Esadaxin IP-osoitteisiin tai validoi User-Agent.

Viisi. Käsittele ja tallenna lokit

Kun se on vahvistettu, jäsennä hyötykuorma ja lähetä se edelleen haluamaasi lokitallennus- tai analytiikkatyökaluun (esim. Datadog, Loki, Sentry, Elasticsearch).

Esimerkki lokinkäsittelyvirrasta:

  • Vahvista → Jäsennä → Suodata (valinnainen) → Tallenna tai hälytä

Kuusi. Vastaa asianmukaisesti

Vastaa aina Esadaxille oikealla HTTP-tilakoodilla:

  • 200 OK: Hyötykuorma vastaanotettu ja vahvistettu onnistuneesti
  • 400 Bad Request: Virheelliset tai puuttuvat tiedot
  • 403 Forbidden: Väärä allekirjoitus

Seitsemän. Testaa asetuksiasi

Ennen liveen menoa:

  • Käytä curl tai Postman lähettää simuloituja hyötykuormia.
  • Testaa sekä kelvollisilla että epäkelvoilla allekirjoituksilla varmistaaksesi logiikkasi.
  • Tarkista lokit ja havaittavuustyökalut varmistaaksesi, että lokit tallennetaan ja tallennetaan oikein.

Esimerkki curl Test (Korvaa salaisella logiikallasi)

curl -X POST https://yourdomain.com/esadax/logs \
  -H "Content-Type: application/json" \
  -H "x-esadax-signature: <calculated_signature>" \
  -d '{ "logs": [...] }'

Yhteenveto

Vaihe Kuvaus
1 Suojatun lokin päätepisteen luominen
2 Toteuta allekirjoituksen tarkistus
3 Määritä tukkien valumat Esadaxiin
4 Käytä HTTPS:ää ja valinnaista IP-vahvistusta
5 Prosessi- ja reittilokitiedot
6 Lähetä asianmukaiset HTTP-vastaukset
7 Testaa kokoonpano kelvollisilla / kelpaamattomilla hyötykuormilla

Tilaa