Cómo guardar más trazas en Home Assistant

Cuando una automatización falla de forma intermitente, necesitas revisar qué ocurrió en esa ejecución concreta. El problema aparece cuando buscas la traza y ya no está disponible. Para investigar estos casos, puedes aumentar el número de trazas que guarda Home Assistant en la automatización afectada.

Conviene separar dos tareas: conservar más ejecuciones para poder consultarlas y corregir el fallo que muestran. Ampliar el historial facilita el diagnóstico, pero no cambia las condiciones ni las acciones de la regla.

Cómo guardar más trazas de una automatización en Home Assistant

Home Assistant conserva cinco trazas por automatización de forma predeterminada. Puedes modificar esa cantidad mediante la opción stored_traces, dentro del bloque trace.

1. Abre Ajustes > Automatizaciones y escenas y selecciona la automatización.
2. Despliega su menú y elige Editar en YAML.
3. Añade este bloque sin sustituir la configuración existente:

trace:
  stored_traces: 20

Coloca trace: al mismo nivel que alias:, triggers:, conditions: o actions:. La línea stored_traces: queda indentada dentro de él. Después, guarda los cambios.

Esta configuración corresponde a esa automatización. Si necesitas ampliar las trazas de otras reglas, añade la opción en cada una. Como punto de partida para investigar un fallo, puedes probar con 20 y ajustar después la cantidad según tus necesidades.

Comprueba el identificador y aplica los cambios correctamente

Si creaste la automatización directamente en YAML, comprueba que tenga un identificador único de texto. El campo alias es su nombre y no sustituye al identificador:

id: "aviso_puerta_entrada"
alias: "Aviso de puerta de entrada"
trace:
  stored_traces: 20

Este fragmento muestra únicamente las opciones relevantes: conserva también los disparadores, condiciones y acciones de tu automatización. Si ya existe un id, mantenlo.

Cuando modificas un archivo YAML fuera del editor, debes recargar las automatizaciones para aplicar los cambios. Ten presente que la recarga puede detener una ejecución en curso de una automatización modificada.

Dónde consultar las trazas y por qué desaparecen

En la lista de automatizaciones, abre el menú de la regla y selecciona Trazas. También puedes acceder desde su editor. Elige la ejecución que quieras investigar y pulsa sobre los pasos del gráfico para consultar sus detalles.

Las ejecuciones nuevas sustituyen a las antiguas al alcanzarse el límite, incluidas las que terminan enseguida. Ampliarlo no recupera trazas descartadas. En un reinicio normal se conservan; un cierre inesperado puede perder las generadas desde el último arranque.

Cómo interpretar una traza para encontrar el fallo

Empieza por localizar el punto donde termina la ejecución:

• Condición no cumplida: comprueba qué requisito impidió continuar. Puede ser un comportamiento correcto de la regla.
• Error en una acción: revisa sus parámetros y el mensaje del dispositivo o de la integración.
• Dispositivo sin respuesta: verifica su disponibilidad y consulta los registros del sistema.
• Sin ejecución nueva: comprueba que la automatización esté habilitada y que realmente se haya producido el cambio que espera el disparador.

Revisa también el modo de ejecución. single impide iniciar otra ejecución mientras la anterior sigue activa; restart detiene la anterior y comienza de nuevo; queued organiza una cola y parallel permite ejecuciones simultáneas. Elige el comportamiento que requiera tu caso.

Si necesitas conservar una ejecución concreta, utiliza Descargar traza en su menú. Antes de compartir el JSON, revisa si contiene contraseñas, tokens, ubicaciones u otros datos personales.