Overvåking og feilsøking

Når noe ikke stemmer, er spørsmålet alltid det samme: hva skjedde med akkurat dette kallet? Spire er bygget for at svaret skal være lett å finne.

Spire-Request-Id

Hvert svar har hodet Spire-Request-Id (og feilsvar har det også i kroppen som request_id). ID-en kan slås opp i dashbordet under Logg i 13 måneder, og viser:

• tidspunkt, metode, sti og API-versjon
• statuskode og svartid, inkludert tid brukt mot eksterne kilder
• hvilken nøkkel som ble brukt (navn, ikke verdi)
• forespørselens kropp med personopplysninger maskert, og svarets kropp
• webhooks som ble utløst av kallet, med leveringsstatus

Lagre ID-en i din egen logg sammen med din egen korrelasjons-ID. Da kan du gå fra en feil hos deg til kallet hos oss på sekunder.

Loggen i dashbordet

Loggen kan filtreres på tid, status, sti, nøkkel og metadata du selv har satt på objekter. Vanlige spørsmål:

• «Hvilke kall feilet med 4xx siste time?» Filtrer status 400–499.
• «Hva skjedde med faktura 10422?» Søk på fak_… eller metadata.ordre_id.
• «Hvorfor fikk vi 429 kl. 03:00?» Filtrer status 429 og se antall kall per sekund rundt tidspunktet.

Loggen kan eksporteres som NDJSON (GET /v1/logg?fra=&til=) og, på Skala og Enterprise, strømmes til ditt SIEM via syslog eller HTTPS.

Forbruk og varsler

Under Forbruk ser du kall per produkt per dag, enhetsforbruk (fakturaer, signaturer, meldinger) og estimert faktura. Sett opp varsler:

Varsler går til e-post, og på Vekst og oppover til Slack, Teams eller en webhook.

Statusabonnement

Statussiden oppdateres av overvåkingen vår og av vakthavende. Abonner på e-post eller RSS for hendelser, og på status.*-webhooks hvis du vil ha dem programmatisk (de er gratis og teller ikke som kall).

Feilsøking steg for steg

Kallet gir 401 eller 403. Sjekk at nøkkelen er riktig miljø (sk_test_ mot sandkasse), at den har rettigheten, og at den ikke er slettet. Dashbordet viser sist brukt per nøkkel.

Kallet gir 400 med felt. Feltet er feil. Se melding og detaljer. Sammenlign med referansen.

Kallet gir 200, men objektet ser ikke ut som forventet. Sjekk Spire-Version i svaret. En annen versjon enn du trodde forklarer de fleste slike tilfeller.

Webhooken kom ikke. Se leveringsloggen for webhooken i dashbordet. Står hendelsen der med feil, er problemet hos mottakeren (status, tidsavbrudd, sertifikat). Står den ikke der, abonnerer webhooken ikke på hendelsestypen, eller filteret ekskluderer objektet.

Webhooken kom to ganger. Forventet. Se duplikater.

Fakturaen ble ikke levert. GET /v1/fakturaer/{id} viser kanal og kvittering. Peppol-avvisninger har årsakskode fra mottaker. E-post som spretter viser mottakerserverens svar.

Svartidene er høye. Loggen viser tid brukt hos oss og tid brukt mot kilde. Er kildetiden høy, se status. Er total tid høy men begge lave, er det nettverket mellom dere og oss; test fra en annen region.

Når du kontakter support

Send Spire-Request-Id for et kall som viser problemet, hva du forventet, og hva du fikk. Det er alt vi trenger for å svare presist. Uten ID må vi gjette, og det tar lenger tid for begge.