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_SECRETympä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,edgetaistatic). - Valitse ympäristöt: Kohdista vain asiaankuuluvat ympäristöt (kuten
productiontaistaging). - 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 onnistuneesti400 Bad Request: Virheelliset tai puuttuvat tiedot403 Forbidden: Väärä allekirjoitus
Seitsemän. Testaa asetuksiasi
Ennen liveen menoa:
- Käytä
curltai 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 |
