Entitet utilgængelig i Home Assistant – sådan finder du årsagen

Tilstanden unavailable fortæller ikke, hvad der er gået galt. Den viser, at en eksisterende entitet ikke kan levere data lige nu. Årsagen kan være enheden, netværket, producentens tjeneste, MQTT-brokeren, integrationen eller en kildeentitet.

God fejlfinding begynder med at afgrænse problemet og kontrollere ét lag ad gangen. Denne vejledning følger den metode uden at slette opsætningen eller genstarte alt på må og få.

unavailable betyder, at entiteten findes i Home Assistant, men at systemet ikke kan nå den eller hente dens data. Enheden kan være offline, integrationen kan være startet forkert, eller kommunikationen kan være afbrudt.

unknown er noget andet: Entiteten findes, men Home Assistant kender ikke dens aktuelle værdi. Den kan eksempelvis vente på den første måling. En manglende entitet, en ukendt værdi og en afbrudt forbindelse er ikke samme fejl.

Entitet, enhed og integration

En entitet er ét datapunkt eller én betjening, for eksempel temperatur eller en kontakt. En enhed samler entiteter fra samme fysiske produkt. En integration er kommunikationslaget mellem Home Assistant og enheden eller tjenesten. Derfor kan en enhed fungere delvist, selv om én entitet er utilgængelig.

• Én entitet: Kontrollér, om den er deaktiveret, fjernet af enheden eller afhænger af en anden datakilde.
• Alle entiteter fra én enhed: Mistænk strømforsyning, enhedens forbindelse eller dens integrationspost.
• Alle enheder i én integration: Kontrollér opsætning, godkendelse, broker, koordinator eller producentens tjeneste.
• Flere uafhængige enheder: Kontrollér netværk, router, DNS, VLAN, strøm til infrastrukturen og Home Assistant.

Notér også, hvornår fejlen opstod: efter en genstart, opdatering, netværksændring, ændret adgangskode eller strømafbrydelse. Det afgrænser ofte årsagen hurtigere end endnu en genstart.

1. Åbn entitetens detaljer, og gå videre til den tilknyttede enhed. Notér integrationens navn og entitets-id.
2. Gå til Indstillinger → Enheder og tjenester. Åbn den relevante integration, og se efter fejl i opsætning eller forbindelse.
3. Kontrollér Indstillinger → System → Reparationer. Her viser Home Assistant registrerede problemer, som kræver handling.
4. Søg i Indstillinger → System → Logfiler efter integrationen, enheden eller entitets-id'et. Fokuser på tidspunktet, hvor fejlen begyndte.
5. Hvis Home Assistant kræver ny godkendelse, skal du gennemføre den uden at fjerne integrationen.
6. Hvis integrationen kan genindlæses, og fejlen kun vedrører den, så genindlæs netop den efter at have gemt relevante logoplysninger.
7. En genstart af Home Assistant giver mening efter en opdatering, en ændring der kræver genstart, eller en fastlåst integration. Gentagne genstarter uden at læse loggen kan skjule sporene.

Læs mere om kommunikationsmetoder i vejledningen om Home Assistant-integrationer.

Bekræft, at enheden har strøm og stadig vises som tilsluttet i routeren. Hvis integrationen bruger en IP-adresse, skal du sammenligne den med enhedens aktuelle adresse. En DHCP-reservation i routeren mindsker risikoen for adresseændringer efter genstart.

Test enheden fra samme netværk, og kontrollér dens app eller lokale webside, hvis den har en. Virker den dér, men ikke fra Home Assistant, bør du undersøge VLAN-regler, firewall, DNS, klientisolering på Wi-Fi og blokeret lokal trafik. Sådan skelner du mellem en enhedsfejl og en afbrudt kommunikationsvej.

Svar på ping beviser ikke, at integrationen virker; den nødvendige port eller protokol kan stadig være blokeret.

Kontrollér internetadgangen fra Home Assistant, og om producenten melder om driftsproblemer. Hvis den officielle app heller ikke kan hente data, ligger fejlen sandsynligvis uden for Home Assistant.

Typiske årsager er en udløbet session eller token, ændret adgangskode, nye login-krav, en API-grænse eller en serverfejl. Brug Home Assistants tilbud om ny godkendelse. Fjern ikke hele integrationen blot for at logge ind igen, da det kan påvirke entitets-id'er og afhængigheder.

Kontrollér forbindelsen mellem Home Assistant og brokeren særskilt fra forbindelsen mellem enheden og brokeren. En fungerende MQTT-integration beviser ikke, at den konkrete enhed publicerer data.

• Lyt på det korrekte state topic, og bekræft, at enheden sender aktuelle data.
• Hvis entiteten bruger availability_topic, skal du kontrollere dens online-/offline-beskeder og enhedens Last Will.
• Efter en genstart kan entiteten vente på en ny besked. Retained messages kan levere den seneste tilstand til en ny abonnent, men vælg bevidst, hvilke data der skal gemmes.
• Manglende aktuel værdi er ikke altid det samme som en utilgængelig enhed. Konfigurationen, availability-beskederne og de modtagne tilstandsdata afgør resultatet.

Dette er målrettet fejlfinding, ikke en komplet MQTT-vejledning. Den bredere sammenhæng findes i vejledningen om integrationer.

Ved én enhed kontrollerer du batteri eller strøm, seneste kommunikation og ruten til Zigbee-routerne. Batterienheder kan sove og rapportere sjældnere, så en manglende forbindelse på netværkskortet er ikke i sig selv bevis på en fejl.

Forsvinder mange enheder samtidigt, skal du kontrollere koordinatoren, forbindelsen til Home Assistant og de strømforsynede routere i mesh-netværket. Efter genstart eller skift af koordinator bør kommunikationen have tid til at komme igen, før alt parres på ny.

En beregnet entitet kan blive utilgængelig, selv om dens egen opsætning er uændret. Én utilgængelig kilde kan være nok. Kontrollér alle entiteter, som skabelonen bruger, og deres aktuelle tilstand.

Håndtér unknown og unavailable før beregninger; den officielle funktion has_value() kontrollerer, om en entitet har en brugbar tilstand. Erstat ikke automatisk manglende data med nul, hvis nul kan aktivere varme, opladning, alarm eller en anden forkert automatisering.

Definér en sikker reaktion på manglende data. Se vejledningen om Home Assistant-automatiseringer for de generelle principper.

1. Åbn den relevante integration under Indstillinger → Enheder og tjenester.
2. Aktivér debug logging kun for denne integration via menuen med tre prikker.
3. Genskab fejlen én gang, og notér tidspunktet.
4. Deaktivér debug logging; Home Assistant klargør loggen til download.
5. Hvis muligheden findes, kan du hente diagnostik fra integrationens eller enhedens menu.
6. Åbn filen før deling, og kontrollér navne, adresser, id'er og andre følsomme oplysninger. Integrationer skal maskere hemmeligheder, men filen bør stadig gennemgås.

Debug logging skaber mange poster. Aktivér det derfor kun under en kort, kontrolleret test, og slå det derefter fra.

• Fjern ikke en integration uden at gemme dens opsætning og afhængigheder.
• Nulstil ikke enheden til fabriksindstillinger, før du ved, hvor kommunikationen svigter.
• Gendan ikke en hel backup på grund af én entitet.
• Ændr ikke flere ting samtidigt; kontrollér resultatet efter hver test.
• Genstart ikke systemet gentagne gange uden først at indsamle logfiler.

Hvis det er uklart, om problemet skyldes enheden, netværket, integrationen, MQTT eller Home Assistant, så beskriv symptomerne. Jeg undersøger først, om jeg reelt kan hjælpe, og hvilket omfang fejlfindingen kræver.

Vejledningen blev kontrolleret den 11. august 2026 ud fra Home Assistants officielle dokumentation:

• entitetstilstande og skabeloner,
• fejlfinding, debug logging og logfiler,
• diagnostik for integrationer,
• Reparationer,
• MQTT og ZHA.