Feature request / feedback. Script / Automation debugger improvements

I recently migrated all of my automations from node red to Home assistant. I’m quite happy with authoring automations (especially with GPT-4’s assistance) but debugging the could be better.

I like the idea of the debugging trace tool, I actually work on a very similar tool in my day job which this inspired. However I think the UX could be improved. Im not a UX designer but have a bit of a background in that space. Here is some feedback

Tab inconsistency

We have 4 tabs at the top. The first one Step details content is contextual to what step you select in the Execution graph.

The other 3 Automation config, trace timeline and related log book entries are static for the whole trace.

This is quite confusing as it keeps breaking my expectations. E.g I select a different step in the execution and Im wondering if trace timeline should change or not?

A good start would be to split step details from the other 3 visually.

Step details

This is probably the most important content so it makes sense to the the first tab.

  1. Why is the result: true duplicated across these 2 sections, Also what do these sections mean, its not clear
  2. The selected state of the current node in the graph is not clear enough imo, its easy to lose where you are in the script graph
  3. A lot of nodes in the graph are not selectable, e.g the choose node. This is very confusing because it still has a hover state implying its intractable
  4. There Is no way to know if there is any content to check in the bottom tabs (Changed variables & logbook entries) you are always paging through. It would be great if this content was always visible or if there was some kind of badge indicator on these tabs telling me there is content here
  5. Tooltips on hover on the script execution nodes would help orientate myself

Trace timeline

I don’t really get what this is and how it’s different from the graph and step details. I don’t understand what causes an entry here

It looks like a high level summary / overview so maybe this would be a good first tab. It seems like some of them are able to select the node they came from in the execution graph which is cool but it doesn’t work for all, again a bit inconsistent

Related log book entries

This is useful and a global version of what is in step details. That said it doesn’t link to the execution step it came from so it’s kind of overlapping with trace time line. plus we already show this in the step details

Summary

Overall the themes of the issues are:

  1. Inconsistent UX on various features, e.g everything should be clickable and go somewhere
  2. Too many tabs / panels to dive through
  3. We show a lot of the same info multiple times in slight different ways, adds to confusion. An interesting idea for your designed would be to try to merge trace timeline, logbook entries and step details into one single script execution tab. And then the other tab is just the full static yaml of what ran.
  4. Inconsistent information hierarchy between execution graph view and tabs, sometimes they are linked, sometimes not

If you think it’s a good idea, you should vote for it. I did :ballot_box_with_check:
Suggested Reading:
More about Feature Requests.

The one I use the most by factors of magnitude it the tab that tells you the variables. That should be the default pop-up.
There are other ways to see the automation or the blueprint or the script or whatever. The history is a little handy but I seldom use it. Following the trace thru the diagram and what the variables are are the ones I use every time.

1 Like

Thanks for the tip

Dog you find thr fact the script graph skips nodes quite confusing ?

Is the script one different than the automation one? I don’t think I’ve noticed that. what nodes?

Ah no poor communication from me. The script and automation debugger are the same I think.

I was referring to the fact when you page thru the steps in the visualisation it can skip nodes since some of them (like choose I think?) are not selectable

2 posts were split to a new topic: Need script help please

I am certainly not searching for individual automation issue solution. I am just giving example how useless the “Step details” part of the automation trace is in it’s current form.

I already deciphered that trace of mine, but it is needlessly hard to do so, which is why I wanted to support the OP by giving more descriptive example in case someone looked at that simple trace in the OP and thought it’s not that bad as he is trying to say.

Sure, in case someone would mention here how you can improve your automation to workaround the fact the current debugger is not very useful it would be great.

But I am certainly talking about generic advice, not something specific to my automation.

Sorry, I must have misunderstood your intentions there. I thought you were asking on how to descipher the debugger to actually fix your automation :wink:

I probably sounded too desperate :wink:

Which I sincerely am anytime some of my complex automations do something weird as I know deciphering that trace would be another nightmare :frowning_face: