Concepts / Designing Failure Mode Panels

Designing Failure Mode Panels

Trust in a dashboard is granted by the reader, and it is often earned by visible honesty about failure rather than by polished metrics alone.

  • Programming

Two Status Reports From One Vendor

Imagine two status reports arriving from the same vendor each month. Both report the same uptime, the same throughput, and the same row of green indicators. The first report stops there and never mentions a problem. The second report also includes a short entry describing an error that reached customers, what was changed to stop it, and how the team will check for it next time. The question this article works through is which report a careful reader should believe.

What do you think happens?

Before reading on, which of the two reports would you expect a skeptical reader to believe more?

  • The first report, because it shows no problems

  • The second report, because it shows a problem with its fix and safeguard

  • Neither, because the metrics are identical

Reveal answer
Answer:

The second report, because it shows a problem with its fix and safeguard

Most readers would not conclude that the second vendor is weaker. Many would conclude the opposite, and would start to believe the numbers in the second report more than those in the first.

The answer is not obvious if you assume that metrics are what persuade people. A dashboard is a set of measurements, and it is easy to assume that those measurements carry the persuasive weight. The source material for this lesson argues that something else often does the persuading: a willingness to show where things went wrong. This article traces how that willingness changes a reader's trust, step by step.

Tracing Trust Across Two Reports

Follow the reader's trust through the two reports. With the first report, the reader sees a clean summary and no failures. The metrics are as good as the reader can check, but nothing in the report shows how the vendor behaves when something goes wrong. The reader has no evidence about that behavior, so the reader has to decide how much to rely on the summary without it.

With the second report, the reader now has evidence about behavior. The report names an error that reached customers, which shows the vendor is willing to say so. It names the change that stopped the error, which shows the vendor acted. It names the check for next time, which shows the vendor is still watching. Each of these facts adds to the reader's picture, and the reader's trust in the other numbers in the report moves accordingly.

Why Visible Failure Builds Belief

The source describes a dashboard built to track failures and metrics for a team working on an AI system used in clinical documentation. The most valued part of that dashboard was a panel devoted to failure modes. The executive sponsor, a chief marketing officer, valued that panel most and said so directly during the engagement.

The reason this mattered is a history of distrust. The same executive had said she had stopped reading vendor status reports years earlier, because she believed vendors concealed bad news. Against that background, the dashboard became the first artifact she trusted. The source treats this as the central purpose of the dashboard: trust earned through visible honesty about failure, rather than trust demanded through a clean-looking summary.

A specific, concrete description of a failure is more credible than a vague one. A panel that never shows problems can invite doubt, because a reader who has seen any real system behave imperfectly may reasonably wonder what is being left out. Honesty about failure therefore does not weaken the dashboard. It is part of how the dashboard earns belief in everything else it shows.

The Three Parts of a Failure Entry

When the team first displayed a real failure on the dashboard, the report recorded three things, in a fixed order. Each part answers a different question a skeptical reader would ask. The diagram below shows how the three parts hand off to one another.

Name the failureWhat happenedName the fixWhat was doneName the safeguardHow it would be known againUnderstood, repaired,watchedWhat the reader canconcludehands off the problemhands off the repairhands off ongoing watch
How do the three parts of a failure report relate to each other in sequence, and what does each one hand off to the next?

A report that contains only the first part tells the reader there was a problem. A report with all three tells the reader that the problem was understood, repaired, and placed under ongoing watch. Each step adds a reason the reader can rely on, and removing any step leaves a question unanswered.

Following a Failure Through the Panel

The safeguard matters most after the fix is in place. Consider what happens if the same failure returns. The diagram below traces the path a failure takes once the safeguard exists, compared with the path it would take without one.

Failure occursFirst appearanceFailure namedReported on the panelFix in placeSystem changedEvaluation case addedTest guards the classFailure returnsSame class of failureDetected by the caseCaught before it goesunnoticedreportedclosed byguarded bywatches forif it returns
After a fix and a safeguard are in place, what happens if the same failure reappears, and how does the safeguard change the path the failure takes?

Notice how the safeguard changes the path. Without an evaluation case, a returning failure has no reliable detector, so its return depends on someone happening to notice it. With the case in place, the same class of failure is detected by design. The reader of the next report can see that loop, and the continuing check is part of what the reader is trusting.

Separating Content From Stance

A helpful way to think about a dashboard is to separate two layers. The first layer is the content: the metrics, the counts, and the charts. The second layer is the stance the content takes toward the reader, which shows in what gets displayed and what gets left out. The source frames the metrics as the medium through which the team communicates, and the honesty as the thing actually being communicated.

Once you see the two layers, the design question changes. Instead of asking only whether a metric is accurate, you also ask whether the dashboard gives a reader reason to believe that accurate metrics would still be shown if they were unflattering. A dashboard can have correct numbers and still fail this second test if it never displays a problem.

Ways Reporting Undermines Its Own Trust

The same content can build trust or erode it, depending on what the report does with its failures. The diagram below contrasts a panel that erodes trust with one that builds it, using the same underlying metrics.

Uptime rowSame metricUptime rowSame metricGreen indicatorsNo problems shownGreen indicatorsSame indicatorsNo failure entrySilence on problemsFailure entryFailure, fix, safeguardunchangedunchangedreplaced by
What does a failure panel look like when it erodes trust compared with one that builds it, and which specific elements cause the difference?
  • Common mistake

    Showing only polished metrics and treating the absence of failures as proof of quality

    What it looks like

    A report lists uptime, throughput, and green indicators, and never mentions a problem.

    Why it fails

    A reader who has seen real systems behave imperfectly may doubt what is being left out, and the clean summary can invite that doubt.

    Do this instead

    Include specific failure entries alongside the metrics, so the reader can see how problems are handled.

  • Common mistake

    Naming a failure vaguely

    What it looks like

    A line saying that something went wrong, with no description of what happened.

    Why it fails

    The reader knows there was a problem but cannot understand it, so the entry adds little credibility.

    Do this instead

    Describe the failure in terms specific enough that a reader could understand what had happened.

  • Common mistake

    Stopping at the admission of a problem

    What it looks like

    A report says a failure occurred, with no fix and no check for recurrence.

    Why it fails

    The reader learns there was a problem but cannot tell whether it was repaired or is being watched.

    Do this instead

    Name the change that closed the failure and the evaluation case that guards against it.

  • Common mistake

    Reporting honesty once and then going quiet

    What it looks like

    One detailed failure entry appears, and every later problem is left out.

    Why it fails

    Trust accumulates through a pattern of candid reporting, so a single disclosure does not build lasting confidence.

    Do this instead

    Report failures consistently over time, with their repair and safeguard each time.

  • Common mistake

    Burying a failure under a more favorable metric

    What it looks like

    A failure is mentioned in a footnote while a flattering number takes the headline.

    Why it fails

    The reader can see that the failure was placed out of view, which signals the opposite of candor.

    Do this instead

    Give the failure its own visible entry, with the three parts stated plainly.

Applying the Pattern to a New Failure

Worked example

Writing a Failure Entry for a New Scenario

A note-drafting feature sometimes produced drafts with a dosage field left blank. Some clinicians caught it, and none reached a patient record, but the team confirmed the defect existed. Write the three parts of an honest failure entry.

  1. 1
    Name the failure

    State specifically what happened: in some drafts, the dosage field was left blank. Say who noticed it and that it was caught before reaching a patient record, rather than writing a vague line that something went wrong.

  2. 2
    Name the fix

    State the change made to the system that closed the failure, such as a corrected handling of the dosage field in drafts. The fix is described as a concrete change, so the reader can see the team acted.

  3. 3
    Name the safeguard

    State the new evaluation case added so the same class of failure would be detected if it returned, such as a test that checks drafts for a filled dosage field. Say how the team will watch for it going forward.

Result

A trustworthy entry gives the reader the specific failure, the concrete repair, and the ongoing check. The reader can then see the problem was understood, repaired, and placed under watch, which is the evidence that builds trust.

Best practice

Report failures completely, with their repair and their safeguard together, and keep reporting them consistently over time. Keep the failure entry visible rather than placing it beneath a more favorable metric, since visibility is part of what the reader is judging.

Practice: Drafting a Trustworthy Entry

MEDIUM

A monthly status report for a search feature shows strong latency and uptime figures. Last month, a ranking change caused some users to see results from the wrong region for two days. The team reverted the change and added an evaluation case that compares region labels on sample queries. Draft the failure entry, then check your draft: does it name the failure specifically, name the fix, and name the safeguard against recurrence? Identify which of the common mistakes your first draft, if any, would fall into.

Hints
  • Start by writing one sentence that describes what users actually saw, in specific terms.
  • Name the revert as the fix, then name the evaluation case as the safeguard.
  • Ask whether a skeptical reader could tell, from your entry alone, that the problem was understood, repaired, and placed under watch.

Key Takeaways

  • Trust in a dashboard is granted by the reader, and it is often earned by visible honesty about failure rather than by polished metrics alone.
  • An honest failure report has three parts in a fixed order: it names the failure, names the change that closed it, and names the evaluation case that guards against recurrence.
  • A safeguard changes the path a returning failure takes, so the same class of failure is detected by design rather than by chance.
  • Trust accumulates through consistent, candid reporting over time; a single disclosure followed by silence does not build lasting confidence.
  • Reporting undermines its own trust when it omits failures, names them vaguely, stops short of a fix or safeguard, or buries them beneath favorable metrics.