mailinapp
Documentation menu

Tachometer-Block

Eine einzelne Kennzahl, dargestellt gegen von Ihnen definierte Gut-/Warnung-/Kritisch-Schwellenbereiche — eine nadelartige Skala, kein zeilenbasiertes Diagramm. Er existiert für die Ablesung „ist diese Zahl gerade in Ordnung“: Verfügbarkeit, Fehlerrate, NPS, Latenz, alles mit einer Gesundheitsstatus-Einordnung statt einem Trend oder einem Vergleich.

Wie es funktioniert

Das Bild zeichnet einen halbkreisförmigen Bogen, der von zwei Schwellenwert-Grenzen in drei farbige Bereiche (gut, Warnung, kritisch) unterteilt ist, mit einem Zeiger, der auf den erfassten Wert zeigt. Anders als jedes Geschwisterdiagramm dieser Familie hat ein Tachometer überhaupt keine Zeilenliste. Seine gesamten „Daten“ bestehen aus fünf skalaren Zahlen: einem Wert, einer Min/Max-Skala und den beiden Schwellenwert-Grenzen — von der Form her näher am einzelnen erfassten Wert der KPI-Kennzahlkarte als an irgendeiner Kategorie-/Reihen-/Punkt-Tabelle.

Das ist auch der Grund, warum der Tachometer der einzige Diagramm-Block in dieser gesamten Familie ohne Datentabelle darunter ist. Eine Datentabelle existiert, um Zahlen zu tragen, die das Bild in Pixeln einschließt, aber der Wert und der Status eines Tachometers werden von vornherein nie eingeschlossen. Sie rendern als echter HTML-Text direkt neben dem Bild: eine fett gedruckte Wertzeile (formatiert als einfache Zahl, Währung oder Prozent), gefolgt von einem farbigen Statuswort („Gut“, „Warnung“ oder „Kritisch“). Eine kleine, gedämpfte Zeile unter dem Bild wiederholt Wert, Status und Skalenbereich. Dieser Text ist bedingungslos vorhanden — er wird gerendert, unabhängig davon, ob das Bild lädt, derselbe nicht verhandelbare Barrierefreiheits-Vertrag, den jedes andere Diagramm der Familie mit einer <table> erfüllt.

Schwellenwertbereiche verwenden immer die reservierte Statuspalette (Grün/Gelb/Rot), niemals ein Feld, das Sie überschreiben können — dieselbe „Rot bedeutet immer schlecht“-Vertrauensregel, der auch die Zunahme-/Abnahme-Farben des Wasserfall-Blocks folgen. goodMax und warningMax teilen die min–max-Skala in dieser Reihenfolge in drei aufsteigende Bereiche: gut, dann Warnung, dann ist alles über warningMax kritisch. Das ist die klassische „Tacho“-Ablesung, bei der niedrig sicher und hoch riskant ist, wie CPU-Auslastung oder Fehlerrate. Eine Kennzahl, bei der hoch tatsächlich gut ist (wie ein NPS- oder Verfügbarkeitswert), erfasst ihre Schwellenwerte einfach umgekehrt, mit goodMax nahe bei max, statt ein separates „Richtungs“-Flag zu benötigen.

Konfigurierbare Felder:

  • Beschriftung — optionaler Überschriftentext über dem Wert.
  • Wert — die Kennzahl selbst, als Text (sodass sie ein Merge-Tag tragen kann).
  • Format — Zahl, Währung oder Prozent, steuert, wie der Wert als Text gerendert wird.
  • Skalenminimum / Skalenmaximum — die min/max-Grenzen der Skala.
  • Guter Bereich bis — die goodMax-Grenze.
  • Warnbereich bis (darüber ist Kritisch) — die warningMax-Grenze; alles darüber wird als kritischer Bereich gerendert.
  • Hintergrundfarbe, Innenabstand, Rahmen und Eckenradius der Karte.
  • Wertfarbe/-größe und Beschriftungsfarbe/-größe — Textgestaltung für die große Wertzeile und die Überschriftsbeschriftung.

Wenn der Wert leer ist oder sich nicht zu einer Zahl auflösen lässt (etwa ein nicht aufgelöstes Merge-Tag), lässt der Block den Bogen weg. Er rendert nur seine Beschriftung und den Kartenrahmen, stattdessen mit dem einfachen Hinweis „Fügen Sie einen numerischen Wert hinzu, um diesen Tachometer zu rendern“. Ein erfasster Bereich, bei dem min >= max ist, oder Schwellenwerte in falscher Reihenfolge werden automatisch begrenzt, statt während der Bearbeitung eine defekte Skala zu erzeugen.

Beispiele

Eine SLA- oder Verfügbarkeits-Momentaufnahme — „99,94 % Verfügbarkeit diesen Monat“, gut bis 99,9 %, Warnung bis 99,5 %, alles darunter kritisch — eingebettet in einen Statusseiten-Digest gibt Abonnenten eine Gesundheitsablesung auf einen Blick, ohne einen Dashboard-Link. Ein Support-Team kann die durchschnittliche Antwortzeit gegen Ziel-SLAs darstellen (gut unter 2 Stunden, Warnung unter 6, darüber kritisch). Ein kundenseitiger NPS- oder Zufriedenheitsbericht kann einen Tachometer als Leitvisual in einer vierteljährlichen Beziehungs-E-Mail verwenden, mit Schwellenwerten so erfasst, dass ein hoher Wert als gut statt als riskant gelesen wird.

So sieht der statische Fallback aus

<div style="margin:12px 0;background-color:#ffffff;padding:16px">
  <p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Uptime this month</p>
  <p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">
    99.94%  <span style="font-size:14px;font-weight:600;color:#16a34a">Good</span>
  </p>
  <img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoi...&s=3f9a2b1c..." width="320" height="200"
       alt="Gauge: 99.94 of 0–100 (Good)" />
  <p style="margin:4px 0 0;font-size:11px;color:#9ca3af">Uptime this month — 99.94% (Good) — scale 0–100</p>
</div>

Die fett gedruckte Wertzeile und die gedämpfte Zusammenfassungszeile unter dem Bild sind beide echter HTML-Text. Wert und Status hängen nie vom Rendern des Bogenbilds ab — deshalb ist der Tachometer der einzige Block in der Familie ohne Datentabelle.

Siehe auch