{"canonical_url":"https://engineer.company/nb/glossary/health-check/","content_markdown":"# Helsesjekk\n\n## Hva det er\n\nEn helsesjekk er en liten test som gjentas etter en fast plan og spør en\nkjørende tjeneste om den kan gjøre jobben sin, sammen med en regel for hva som\nskjer når svaret er nei. Testen kan være en HTTP-forespørsel til en egen sti, en\nkommando som kjøres inne i en container, eller et forsøk på å åpne en TCP-port.\nDet er regelen som gjør sjekken til mer enn en måling: en mislykket helsesjekk\nkan ta en server ut av rotasjon, starte en container på nytt, stanse en\nproduksjonssetting eller vekke noen midt på natten.\n\nDocker bygger ideen inn i selve imaget. Instruksjonen `HEALTHCHECK` i en\nDockerfile angir en kommando som Docker kjører inne i containeren med et fast\nintervall. Avslutningskode 0 betyr frisk, 1 betyr usunn, og 2 er reservert og\nskal ikke brukes. En container med en sjekk starter i tilstanden `starting`,\nblir `healthy` så snart én sjekk går gjennom, og går over til `unhealthy` etter\net fastsatt antall feil på rad. Standardverdiene er en sjekk hvert 30. sekund,\net tidsavbrudd på 30 sekunder og tre forsøk; en kjøring som overskrider\ntidsavbruddet, teller som en feil, og prosessen blir drept. En valgfri\nstartperiode gir et tregt program tid til å starte, og feil innenfor den teller\nikke. En Dockerfile har én slik instruksjon, den siste gjelder hvis det står\nflere, og `HEALTHCHECK NONE` slår av en sjekk som er arvet fra basisimaget.\n\nKubernetes deler spørsmålet i tre prober, hver med sin egen konsekvens. En\nstartup-probe spør om programmet er ferdig med å starte; til den lykkes, venter\nde to andre, og fortsetter den å feile, blir containeren drept og håndtert etter\nomstartspolicyen sin. En liveness-probe spør om containeren bør startes på nytt,\nog er ment for tilstander som en vranglås (deadlock), der prosessen kjører, men\nikke kommer videre. En readiness-probe spør om containeren skal få trafikk. Når\nden feiler, blir ingenting startet på nytt; i stedet fjernes adressen til Pod-en\nfra endepunktene til hver Service som velger den, og forespørslene går til de\nandre replikaene til proben går gjennom igjen.\n\nHver probe bruker én av fire mekanismer. En `httpGet`-probe går gjennom på\nenhver statuskode fra og med 200 til og med 399. En `tcpSocket`-probe går\ngjennom hvis porten tar imot en tilkobling, også en som lukkes med en gang. En\n`grpc`-probe går gjennom når tjenestens helsesjekk i gRPC svarer `SERVING`. En\n`exec`-probe kjører en kommando i containeren og går gjennom på\navslutningskode 0. Om ikke annet er angitt, prober Kubernetes hvert tiende\nsekund, venter ett sekund på svar og handler etter tre feil på rad.\n\nLastbalanserere legger til en annen sort. Sjekkene ovenfor er aktive: noe sender\nen testforespørsel enten det er brukere der eller ikke. En passiv sjekk følger i\nstedet med på den virkelige trafikken. Slik fungerer nginx med åpen kildekode:\nnår en forespørsel til en upstream-server ender med en feil, merker nginx\nserveren som feilet og unngår den en stund, og med standardverdien 1 for\n`max_fails` er ett mislykket forsøk nok. Ifølge dokumentasjonen til nginx hører\nhelsesjekker av applikasjoner (application health checks) til funksjonene i de\nbetalte NGINX Plus-abonnementene. En passiv sjekk koster ingenting ekstra, men\nden får vite om en ødelagt server gjennom en brukers mislykkede forespørsel, og\nden sier ingenting om en server som ikke får trafikk.\n\n## Hvorfor det er viktig\n\nEn prosess som kjører, er ikke det samme som en tjeneste som virker. Referansen\ntil Docker nevner det typiske eksempelet: en webserver som har hengt seg i en\nuendelig løkke og sluttet å ta imot tilkoblinger, mens prosessen fortsatt lever.\nAlt som bare følger med på om prosessen finnes, som en\n[systemd](/nb/glossary/#systemd)-enhet med omstartspolicy, ser ingenting galt.\nBare et spørsmål som stilles gjennom den samme døren som brukerne går inn\ngjennom, kan se forskjellen, og det er hele begrunnelsen for en helsesjekk: den\nbytter ut «kjører den?» med «svarer den?».\n\nTo beslutninger avgjør om en sjekk er nyttig eller farlig. Den første er hva\nsjekken tester, og det er i praksis en definisjon av «virker», skrevet i kode.\nEn handler som returnerer 200 uten å røre noe, beviser at webrammeverket er\noppe; en handler som også spør databasen, beviser at databasen kan nås, og\nfeiler når den ikke kan det. Den andre er hva som skjer ved feil, og den avgjør\nhvor langt skaden rekker. Å ta én replika ut av rotasjon er billig og kan gjøres\nom. Å starte den på nytt kaster bort arbeidet den holdt på med og de varme\ncachene, og hvis alle replikaene feiler den samme sjekken samtidig, gjør en\nomstart av alle sammen en treg avhengighet om til et fullstendig driftsavbrudd.\n\nKubernetes advarer nettopp mot dette. Dokumentasjonen sier at liveness-prober må\nsettes opp slik at de virkelig viser en feil programmet ikke kommer seg av på\negen hånd, og at en feil implementering kan gi kaskadefeil: containere som\nstartes på nytt under høy last, klientforespørsler som feiler, og mer arbeid på\npodene som er igjen. Rådet som følger, er å holde de to spørsmålene fra\nhverandre. Når et program er strengt avhengig av bakenforliggende tjenester,\nskal liveness-proben gå gjennom så lenge programmet selv er friskt, mens\nreadiness-proben også sjekker hver nødvendig tjeneste bak. Da unngår trafikken\nen Pod som bare kunne svart med feil, og Pod-en blir ikke drept for en feil som\nligger et annet sted.\n\nHelsesjekker kommer også [overvåkingen](/nb/glossary/#monitoring) til gode. Et\nendepunkt som en lastbalanserer spør, kan også spørres utenfra, og\ndriftsvarselet som går når det feiler, er ofte det første tegnet på en\n[driftshendelse](/nb/glossary/#incident). Da Irakli Nadareishvili skrev Health\nCheck Response Format for HTTP APIs, et Internet-Draft i IETF, fantes det ingen\nstandard for hva et slikt endepunkt skal returnere, og de fleste programmer\nnøyde seg med HTTP-statuskoden eller brukte et eget format. Utkastet foreslo et\nJSON-svar med medietypen `application/health+json` og et obligatorisk\n`status`-felt med verdien `pass`, `fail` eller `warn`, der `pass` og `warn`\nhører sammen med en statuskode i 2xx eller 3xx, og `fail` med en i 4xx eller\n5xx. Den siste versjonen, fra oktober 2021, utløp i april 2022, og IETF oppgir\nat den verken er godkjent av IETF eller har formell status. Den er nyttig som et\nfelles vokabular, ikke som en standard.\n\n## Slik ser det ut i praksis\n\nI en Dockerfile følger sjekken med imaget den sjekker. Her spør programmets eget\nlille probeprogram etter en sti på localhost og avslutter med 0 eller 1:\n\n```dockerfile\nHEALTHCHECK --interval=15s --timeout=3s --start-period=60s --retries=3 \\\n  CMD [\"/app/bin/probe\", \"http://127.0.0.1:8080/livez\"]\n```\n\nDocker kjører proben hvert 15. sekund og gir hver kjøring tre sekunder. Feil i\nløpet av det første minuttet teller ikke med mindre en sjekk allerede har gått\ngjennom, og på Docker Engine 25.0 eller nyere kjøres sjekkene i det minuttet\nhvert femte sekund, som er standardintervallet i startperioden, slik at en rask\noppstart blir oppdaget raskt. Etter tre feil på rad merkes containeren som\n`unhealthy`. De første 4096 bytene av utdataene fra proben lagres for\n`docker inspect`, og hver statusendring sender ut en `health_status`-hendelse.\nReferansen beskriver en status, ikke en handling: noe annet må reagere på den.\n\nI Kubernetes kan de tre probene få hver sin sti, slik at hver av dem stiller\nsitt eget spørsmål:\n\n```yaml\ncontainers:\n  - name: api\n    ports:\n      - containerPort: 8080\n    startupProbe:\n      httpGet: { path: /livez, port: 8080 }\n      periodSeconds: 5\n      failureThreshold: 24 # opptil 2 minutter på å starte\n    livenessProbe:\n      httpGet: { path: /livez, port: 8080 }\n      periodSeconds: 10\n      timeoutSeconds: 2\n      failureThreshold: 6 # omtrent ett minutt før omstart\n    readinessProbe:\n      httpGet: { path: /readyz, port: 8080 }\n      periodSeconds: 5\n      timeoutSeconds: 2\n      failureThreshold: 2\n```\n\n`/livez` svarer bare for selve prosessen, mens `/readyz` også sjekker databasen\nog alt annet en forespørsel ikke klarer seg uten. Startup-proben bruker\nliveness-stien, slik dokumentasjonen til Kubernetes anbefaler, og gir 24 × 5\nsekunder før containeren blir oppgitt. Når den har gått gjennom, tar liveness\nover med lang lunte og readiness med kort: rundt ti sekunder med feil tar Pod-en\nut av Servicen, og ett minutt med feil starter den på nytt. Standardverdiene\nville gitt tre feil med ti sekunders mellomrom, og det er for lite for et\nprogram som trenger to minutter på å laste inn dataene sine. Dokumentasjonens\negen tommelfingerregel er at en container som vanligvis bruker lengre tid på å\nstarte enn initialDelaySeconds pluss failureThreshold × periodSeconds, trenger\nen startup-probe.\n\nEn helsesjekk kan også snus på hodet. I [vertsovervåking med dødmannsknapp](/nb/portfolio/built-dead-mans-switch-host-monitoring/), fra september 2026, sjekker en vert på 464 MB som kjører en forge og en webserver, seg selv hvert femtende minutt, med jitter: et lite skript måler tilgjengelig minne og ledig disk og pinger en ekstern tjeneste bare når begge ligger over tersklene sine. Tausheten er varselet. En vert som har gått tom for minne, mistet nettverket eller sluttet å starte, gir det samme signalet som en som bare er usunn, og derfor ble denne formen valgt fremfor en agent som rapporterer en status. Sjekken leser tilgjengelig minne og ikke ledig minne, fordi kjernen bruker minne som ellers står ubrukt, til cache, og seks variabelnavn som sa «free», ble rettet, så ingen skulle «fikse» en alarm som virker, til en som slår ut hele tiden. Et mottatt signal bekrefter at skriptet kjørte, og at terskelkontrollene for tilgjengelig minne og ledig diskplass ble bestått; det dokumenterer ikke vertens generelle tilstand eller at nettstedet svarer. Overvåking kan avdekke varselsignaler, men tidspunktet avhenger av belastningen og forholdene som observeres.\n\nEn sjekk ved oppstart svarer på enda et spørsmål. I\n[e-post med failover og leveringslogging](/nb/portfolio/built-email-with-failover-and-delivery-logging/),\nfra 2025, går e-posten gjennom tre leverandører med automatisk failover, og\nforan alt dette sender en oppstartskontroll en ekte melding gjennom hele\nstakken, styrt av et flagg. I utvikling logger en feil en advarsel, og\nprogrammet fortsetter; i staging og produksjon er feilen fatal, og prosessen\navslutter heller enn å produksjonssette et bygg som ikke kan sende e-post. Siden\noppsummerer resultatet slik: en hel kategori stille feil gikk fra «en bruker\nmerker det dager senere» til «produksjonssettingen stopper».\n\n## Hvor det går galt\n\n**Sjekken beviser bare at prosessen svarer.** En handler som returnerer 200 uten\nå røre noe, forblir grønn mens databasen er utilgjengelig, disken er full eller\nhver eneste ekte forespørsel ender med en feil. La readiness-sjekken prøve ut\ndet en forespørsel trenger, på en billig måte, og legg til en sjekk utenfra som\nfølger brukerens vei gjennom DNS, TLS og lastbalansereren, for kubelet sender\nprobene sine rett til IP-adressen til Pod-en og ser ingenting av dette.\n\n**Liveness avhenger av noe utenfor containeren.** Hvis liveness-proben spør\ndatabasen, får en treg database den til å feile i alle replikaene samtidig, og\nKubernetes starter dem alle på nytt akkurat når tjenesten allerede sliter. La\nliveness bare svare for selve prosessen, slik dokumentasjonen til Kubernetes\nråder til, og legg avhengighetene i readiness, der en feil leder trafikken bort\ni stedet for å drepe containere.\n\n**Tidsinnstillingene passer ikke til programmet.** Kubernetes venter som\nstandard ett sekund på svar, så et endepunkt som blir tregere under last, feiler\nmens programmet bare har mye å gjøre, og en container som starter tregere enn\nliveness-proben tillater, blir drept før den er klar, igjen og igjen. Mål hvor\nlang tid endepunktet bruker under last, og sett tidsavbruddet over det, og gi\ntrege programmer en startup-probe som er dimensjonert etter den tregeste reelle\noppstarten.\n\n**En omdirigering går gjennom.** En HTTP-probe i Kubernetes regner enhver status\nfra 200 til 399 som suksess, så en sti som omdirigerer til en innloggingsside,\nser frisk ut. Peker omdirigeringen til en annen vert, følger ikke kubelet den,\nmen registrerer proben som vellykket med en advarsel. Med HTTPS hopper kubelet\ndessuten over sertifikatkontrollen, så et utløpt sertifikat får aldri en probe\ntil å feile. Pek probene mot en sti som svarer 200 direkte og returnerer en 5xx\nnår noe er galt, og sjekk sertifikatene utenfra.\n\n**Endepunktet forteller for mye til for mange.** Et detaljert svar som lister\nopp hver avhengighet, versjon og vertsnavn, informerer en angriper like godt som\nen lastbalanserer, og sikkerhetsavsnittet i utkastet påpeker at endepunkter for\nhelsesjekk kan trenge autentisering og rollebasert tilgangskontroll. Begrens det\noffentlige svaret til en status, og vis detaljene bare på en intern port eller\ntil autentiserte klienter.\n\n**Sjekken koster mer enn den burde.** Kubernetes advarer om at `exec`-prober\nstarter nye prosesser ved hver kjøring, noe som på tettpakkede noder med korte\nintervaller kan øke CPU-belastningen på noden, og en probe som kjører en tung\nspørring med noen sekunders mellomrom på hver replika, er en belastning i seg\nselv. Foretrekk HTTP-, TCP- eller gRPC-prober, hold endepunktet billig, og\nmellomlagre resultatet av en dyr avhengighetssjekk i noen sekunder i stedet for\nå gjenta den for hver probe.\n\n## Les mer\n\n- [Dockerfile reference: HEALTHCHECK](https://docs.docker.com/reference/dockerfile/#healthcheck)\n  — instruksjonen, valgene og standardverdiene, og hva hver avslutningskode\n  betyr.\n- [Liveness, Readiness, and Startup Probes](https://kubernetes.io/docs/concepts/workloads/pods/probes/)\n  — hva hver probetype gjør, de fire sjekkmekanismene og alle\n  konfigurasjonsfeltene med standardverdiene sine.\n- [Configure Liveness, Readiness and Startup Probes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)\n  — gjennomgåtte eksempler, blant annet en startup-probe som gir et tregt\n  program fem minutter.\n- [Health Check Response Format for HTTP APIs](https://datatracker.ietf.org/doc/draft-inadarei-api-health-check/)\n  — det utløpte Internet-Draftet bak `application/health+json` og statusene\n  pass, fail og warn.\n- [Using nginx as HTTP load balancer](https://nginx.org/en/docs/http/load_balancing.html)\n  — de passive helsesjekkene i nginx med åpen kildekode, som skjer i selve\n  trafikken (in-band), og innstillingene `max_fails` og `fail_timeout`.\n\n\u003chttps://engineer.company/nb/glossary/health-check/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvordan en kjørende tjeneste blir spurt om den kan gjøre jobben sin, hva Docker og Kubernetes gjør med svaret, og hvordan en dårlig sjekk gir nedetid.","formats":{"gemtext":"https://engineer.company/nb/glossary/health-check/index.gmi","gopher":"https://engineer.company/nb/glossary/health-check/gophermap","html":"https://engineer.company/nb/glossary/health-check/","json":"https://engineer.company/nb/glossary/health-check/index.json","markdown":"https://engineer.company/nb/glossary/health-check/index.md","pdf":"https://engineer.company/nb/glossary/health-check/index.pdf"},"kind":"page","language":"nb","title":"Hva er en helsesjekk?","url":"https://engineer.company/nb/glossary/health-check/","version":1}