Home Assistant Debug Template

Kategori

debug

Status

Guld

Bruges til

Denne prompt bruges når TuxCore skal fejlfinde Home Assistant automations, scripts, YAML, dashboards, entity IDs, webhooks, REST sensors eller service calls.

Den er god til:

• Automation trigger ikke
• YAML indentation fejl
• Entity findes ikke
• Service call fejler
• REST sensor virker ikke
• Webhook modtager ikke data
• Dashboard card viser forkert
• Template sensor giver unknown/unavailable
• Google Home/media_player virker ikke
• ESP/API integration uden MQTT fejler

Prompt

$ha $debug

Jeg har et Home Assistant problem.

## Problem

[Beskriv hvad der ikke virker]

## YAML / automation / script

[indsæt relevant YAML]

## Fejlbesked

[indsæt fejl fra Home Assistant logs, UI eller Developer Tools]

## Entity IDs

[indsæt relevante entity IDs]

## Hvad jeg forventede

[Beskriv hvad der skulle ske]

## Hvad der faktisk sker

[Beskriv hvad der sker i stedet]

## Miljø

- Home Assistant type: [HAOS / Docker / andet]
- Integration: [ZHA / REST / webhook / ESP / Google Home / andet]
- MQTT bruges: [ja/nej]
- API/webhook ønskes: [ja/nej]

## Det jeg vil have

Svar med:

1. Hvad fejlen betyder.
2. Mest sandsynlige årsag.
3. Hvor YAML eller entity ID sandsynligvis er forkert.
4. Præcis rettelse.
5. Copy/paste-klar YAML.
6. Test i Developer Tools.
7. Næste fejlfindingstrin hvis det stadig ikke virker.

Regler:

- Brug dansk forklaring.
- Brug korrekt YAML-indryk.
- Undgå MQTT hvis API/webhook ønskes.
- Brug eksisterende entity IDs fra input.
- Forklar hvor YAML skal indsættes.
- Gør svaret copy/paste-klar.

Eksempel på brug

$ha $debug

Min automation tænder ikke lyset når lux er under 10 og der er bevægelse.
Her er YAML og entity IDs.

Forventet output

Et godt svar bør indeholde:

• Kort diagnose
• Rettet YAML
• Forklaring af conditions/triggers
• Developer Tools test
• Automation trace tjek
• Eventuelle entity ID rettelser
• Reload/testtrin

Standard debug-trin

1. Tjek entity state

Developer Tools
→ States
→ søg efter entity_id

Tjek:

• Findes entity?
• Hvad er faktisk state?
• Er state on, off, unknown, unavailable eller noget andet?

2. Test service call

Developer Tools
→ Services
→ vælg service
→ udfyld YAML
→ Call service

3. Tjek automation trace

Settings
→ Automations & Scenes
→ vælg automation
→ Traces

Tjek:

• Blev trigger aktiveret?
• Blev condition blokeret?
• Blev action kørt?

4. Tjek logs

Settings
→ System
→ Logs

Typiske fejl

YAML indentation fejl

Mulige årsager:

• Forkert antal spaces
• Tabs i stedet for spaces
• data, target, sequence eller conditions ligger forkert
• Listepunkt - mangler

Fix:

• Brug 2 spaces
• Ingen tabs
• Valider YAML
• Sammenlign med en kendt fungerende automation

Entity findes ikke

Mulige årsager:

• Entity ID er stavet forkert
• Entity er renamed
• Device/integration er offline
• Entity er disabled
• Domænet er forkert, fx switch i stedet for light

Fix:

• Kopiér entity ID direkte fra Developer Tools → States
• Tjek integrationens entities
• Tjek om device er online

Automation trigger ikke

Mulige årsager:

• Trigger state matcher ikke faktisk state
• Automation er disabled
• Forkert entity ID
• Trigger kræver state change, men state ændrer sig ikke
• for: forsinker triggeren

Fix:

• Tjek trace
• Test med en simpel trigger
• Fjern conditions midlertidigt
• Tjek faktisk state i Developer Tools

Condition blokerer

Mulige årsager:

• LUX sensor har anden enhed/værdi
• State er string og ikke number
• Tid/dag condition matcher ikke
• Entity er unknown

Fix:

• Tjek condition i trace
• Tjek sensorværdi live
• Test uden condition
• Tilføj fallback hvis sensor er unavailable

Service call fejler

Mulige årsager:

• Forkert service-navn
• Entity understøtter ikke service
• Forkert target / data
• Integration mangler
• Dataformat er forkert

Fix:

• Test service i Developer Tools
• Brug UI til at generere YAML
• Tjek logs

REST sensor virker ikke

Mulige årsager:

• Endpoint svarer ikke
• Forkert JSON
• Forkert value_template
• Home Assistant kan ikke nå IP/host
• HTTPS/SSL problem
• Endpoint kræver auth

Fix:

bn endpoint i browser

• Test fra lokalnet
• Tjek JSON format
• Brug json_attributes
• Brug scan_interval

Webhook virker ikke

Mulige årsager:

• Forkert webhook_id
• Forkert HTTP method
• local_only blokerer ekstern request
• ESP/server rammer forkert URL
• Home Assistant er ikke tilgængelig fra afsender

Fix:

• Tjek webhook URL
• Brug POST hvis automation kræver POST
• Test med curl
• Tjek automation trace

Eksempel test med curl:

curl -X POST http://homeassistant.local:8123/api/webhook/WEBHOOK_ID

Template sensor viser unknown

Mulige årsager:

• Forkert entity ID
• Attribute findes ikke
• JSON path er forkert
• Sensor er unavailable
• Template mangler fallback

Fix:

state: "{{ state_attr('sensor.example', 'rssi') | default(0) }}"

eller:

state: >
  {% set value = state_attr('sensor.example', 'rssi') %}
  {{ value if value is not none else 0 }}

Standard rettet automation eksempel

alias: Tænd lys ved lav lux og bevægelse
description: Tænder lys når der er bevægelse og lux er under 10.
mode: restart
trigger:
  - platform: state
    entity_id: binary_sensor.motion_sensor
    to: "on"
condition:
  - condition: numeric_state
    entity_id: sensor.lux_sensor
    below: 10
action:
  - service: light.turn_on
    target:
      entity_id: light.room_light

Webhook eksempel

alias: ESP webhook debug test
description: Tester webhook fra ESP/API.
mode: queued
trigger:
  - platform: webhook
    webhook_id: esp_debug_test
    allowed_methods:
      - POST
    local_only: true
condition: []
action:
  - service: persistent_notification.create
    data:
      title: "Webhook modtaget"
      message: "Home Assistant modtog ESP webhook."

REST command eksempel

rest_command:
  esp_relay_on:
    url: "http://192.168.2.50/relay/on"
    method: GET

Sikkerhedsregler

• Del ikke long-lived access tokens.
• Hardcode ikke secrets i dashboards.
• Brug local_only: true på webhooks når muligt.
• Eksponér ikke Home Assistant direkte mod internettet uden sikker adgang.
• Brug lokale IP'er/VPN hvor muligt.
• Brug ikke MQTT hvis API/webhook er kravet.

Tags

home-assistant, debug, yaml, automation, webhook, rest, dashboard, entity-id, tuxcore