Når en integration mellem webshoppen og et andet system fejler, er et godt fejlspor værdifuldt. Men en log behøver ikke at være en kopi af alle oplysninger, som systemerne udveksler. Cloudflares gennemgang fra 12. oktober 2026 sætter fokus på at filtrere og tilpasse logs, før de sendes videre. Det er en god anledning til at gennemgå, hvad din egen løsning gemmer.
Hvad viser Cloudflares gennemgang?
I artiklen om Transformers i Logpush forklarer Cloudflare, hvordan SQL-regler kan vælge hændelser, fjerne eller maskere felter og ændre strukturen før eksport. En log er en registrering af hændelser i et system, eksempelvis tidspunktet for en forespørgsel og dens resultat.
Gennemgangen beskriver en funktion, som ifølge Cloudflare blev gjort generelt tilgængelig under den seneste Birthday Week. Den er derfor ikke lanceret den 12. oktober. Den aktuelle artikel går nærmere ind i, hvordan behandlingen før eksport fungerer. Reglerne skal vælges og afprøves til den konkrete opsætning.
Start med det spørgsmål, loggen skal besvare
Vores råd er at tage udgangspunkt i én arbejdsgang. Det kan være en produktopdatering fra et leverandørsystem til WooCommerce. Hvad skal den ansvarlige kunne se, når opdateringen ikke kommer frem? Beskriv de nødvendige trin og aftal, hvilke oplysninger der gør det muligt at undersøge dem.
En klar beskrivelse af et mislykket trin kan være mere brugbar end et stort udtræk uden sammenhæng. Aftal også, hvem der følger op på fejlen. En log, som ingen gennemgår, giver ikke i sig selv den ansvarlige besked om, at en opgave kræver handling.
Bevar sammenhængen og begræns følsomme felter
OWASPs vejledning om logging beskriver blandt andet tid, hændelse, resultat og en identifikator, som kan forbinde relevante trin. Den anbefaler samtidig særlig behandling af oplysninger som adgangstokens, passwords og andre hemmeligheder frem for at skrive dem direkte i loggen.
Vores forslag er at vælge en lille, dokumenteret samling felter. Brug eksempelvis tidspunkt, navn på integrationen, operation, resultat og en teknisk reference til kørslen. Afklar behovet for hver oplysning. Felter med kundedata eller indhold fra forespørgsler kræver en konkret vurdering, før de gemmes eller eksporteres.
Et eksempel på en afgrænset fejlbeskrivelse
Tænk på en planlagt produktimport, hvor forbindelsen til leverandøren afbrydes. En brugbar registrering kan fortælle, hvilken import der kørte, hvilket trin der stoppede, og hvilken fejltype der blev modtaget. Den kan også vise, om kørslen blev afsluttet, afbrudt eller lagt til senere behandling.
Dette er et tænkt teknisk eksempel, ikke en kundecase. Pointen er at kunne følge forløbet uden automatisk at kopiere hele leverandørfilen eller adgangsnøglen ind i fejlbeskrivelsen. Den ansvarlige bør desuden kunne skelne mellem en fejl i forbindelsen og en fejl i selve produktdataene, når systemet giver grundlag for det.
Afprøv både det bevarede og det fjernede
Vores anbefaling er at bruge konstruerede testdata og kontrollere udtrækket i det system, der faktisk modtager det. Kan du stadig finde den relevante fejl og følge kørslen? Er et felt, der skulle udelades, også væk i den eksporterede kopi? Test flere af de hændelser, arbejdsgangen kan give.
OWASP fremhæver også test af logfunktioner og adgangskontrol. Aftal derfor adgang, opbevaring og opfølgning med den tekniske ansvarlige. Hvis et filter fjerner nødvendige fejlspor, skal opsætningen justeres. Dokumentér reglerne, så næste ændring af integrationen også omfatter en kontrol af loggen.
Logging som en del af integrationsopgaven
Hos KPdesign arbejder vi med API-integrationer, automatisering og fejlhåndtering med logging. Det er vores egen kommercielle ydelse. Omfang og dokumentation aftales konkret. Ved en ny integration kan vi derfor afklare både dataudvekslingen og det fejlspor, der skal hjælpe med den efterfølgende drift.