Dein erster KPI

Diese Seite bringt einen KPI von null bis zur fertigen Karte auf dem Dashboard. Das dauert etwa fünf Minuten. Der erste Durchgang ist ein manueller KPI — eine Zahl, die du selbst einträgst. Der zweite ist ein Connector-KPI, der sich seinen Wert selbst holt.

Wenn Pulsaria noch nicht installiert ist, beginne mit Installation & erster Start.

Projekt anlegen (optional)

Ein KPI ist entweder Unternehmensweit oder einem Projekt zugeordnet. Unternehmensweit ist die Vorgabe, und du kannst einen KPI später verschieben — diesen Abschnitt kannst du also überspringen und wiederkommen, sobald du mehr als eine Handvoll KPIs hast.

1. Klick in der Seitenleiste auf Projekte.
2. Klick oben rechts auf Neues Projekt.
3. Fülle Name aus — das einzige Pflichtfeld, Platzhalter z. B. Wachstum 2026.
4. Optional: Beschreibung und Status — Aktiv, Pausiert oder Abgeschlossen. Neue Projekte starten als Aktiv.
5. Klick auf Projekt anlegen.

Das Projekt bekommt sofort einen eigenen Abschnitt auf dem Dashboard, mit eigenem + KPI-Button — auch solange es noch leer ist.

Ein Projekt zu löschen löscht auch alle KPIs darin und deren komplette Werte-Historie. Ohne Undo. Nutze Projekte zum Gruppieren, nicht als Ordner, den du später mal aufräumst.

Mehr dazu unter Projekte.

Manuellen KPI anlegen

Bei einer frischen Installation zeigt das Dashboard ein Willkommens-Panel mit drei Buttons: Projekt anlegen, KPI anlegen und Vorlage verwenden. Sobald ein KPI oder ein Projekt existiert, weicht dieses Panel den gruppierten Abschnitten, jeder mit einem + KPI-Button in der Kopfzeile.

1. Öffne das Dashboard und klick auf KPI anlegen (frische Installation) oder auf + KPI in der Kopfzeile der Gruppe, zu der der KPI gehören soll. Die Gruppe bestimmt den vorausgewählten Bereich.
2. Der Dialog startet mit der Frage „Woher kommen die Daten dieser KPI? Du kannst das später ändern.“ und vier Karten: Manuell, Connector, Bash, HTTP. Klick auf Manuell.
3. Das Formular erscheint, geteilt in den Abschnitt Datenquelle (bei einem manuellen KPI nur ein Hinweissatz) und den Abschnitt Ziel. Fülle die Ziel-Felder aus — siehe Tabelle unten.
4. Klick auf KPI anlegen.

Du bekommst einen „KPI erstellt“-Toast, der Dialog schließt sich, und die Karte erscheint sofort in ihrer Gruppe.

Die Felder im Abschnitt Ziel

Feld	Wirkung
Name	Pflichtfeld. Freitext, Platzhalter z. B. Umsatzwachstum. Ohne Namen blockiert „Name ist erforderlich“ das Speichern.
Einheit	Freitext, vorbelegt mit %. Sie steht neben jeder Zahl — EUR, hours, count, Bestellungen, ganz wie du magst. Wird nie validiert, eine leere Einheit lässt sich also speichern.
Zielwert	Pflichtfeld. Muss eine Zahl größer als 0 sein, sonst „Zielwert muss eine Zahl größer als 0 sein“.
Richtung	Höher ist besser (Vorgabe) oder Niedriger ist besser. Das dreht die gesamte Farblogik um — bei „Niedriger ist besser“ ist unterhalb der Linie gut.
Bereich	Unternehmensweit oder eines deiner Projekte.
Zeitraum	Jahr, Monat, Quartal oder Benutzerdefiniert. Bei Benutzerdefiniert erscheinen Startdatum und Enddatum, beide Pflicht.
KPI-Typ	Kumulatives Ziel (Vorgabe) oder Wiederkehrender Wert. Siehe unten.

Fehler erscheinen, sobald du ein Feld verlässt oder auf Speichern drückst — nicht schon beim Tippen.

Das Feld Zielwert ist ein einfaches Zahlenfeld. Die Wertefelder unter Tägliche Erfassung verstehen sowohl 1.234,56 als auch 1,234.56; der Zielwert läuft nicht durch diesen Parser. Tipp ihn so, wie das Zahlenfeld deines Systems ihn erwartet.

Kumulatives Ziel oder wiederkehrender Wert

Diese Wahl bestimmt, womit Pulsaria deinen Wert vergleicht — und sie ist die eine Einstellung, die beim ersten KPI gern danebengeht.

• Kumulatives Ziel — „Wert summiert sich zum Ziel (z.B. Umsatz)“. Die Zahl, die du erfasst, ist ein laufender Gesamtwert für den Zeitraum, und die Referenzlinie wächst gleichmäßig von 0 am ersten Tag bis zum Zielwert am Ende. Umsatz, Neuanmeldungen, geleistete Stunden.
• Wiederkehrender Wert — „Je Periode ein neuer Messwert gegen einen Zielwert (z.B. MAU)“. Jeder Messwert steht für sich und wird gegen eine flache Referenz gemessen: den Zielwert, an jedem Tag. Aktive Nutzer, Conversion-Rate, Antwortzeit, Churn.

Du kannst das später ändern, aber die Änderung bewertet die gesamte Historie neu — die alte Bewertung wird nirgends aufbewahrt.

Zeitraum

Jahr, Monat und Quartal meinen immer das laufende Kalenderjahr, den laufenden Monat, das laufende Quartal, und sie rollen von selbst weiter: Ein Monats-KPI startet am 1. mit einer frischen Referenzlinie. Eine Woche als Zeitraum gibt es nicht, und ein verschobenes Geschäftsjahr auch nicht — Benutzerdefiniert ist der einzige Weg zu einem selbst gewählten Fenster.

Details unter Zeiträume & Ziele.

Den heutigen Wert erfassen

1. Klick in der Seitenleiste auf Tägliche Erfassung.
2. Das Feld Datum oben steht auf heute. Lass ihn stehen.
3. Wähle einen Bereich: Alle Bereiche, Unternehmensweit oder ein Projekt, jeweils mit der KPI-Anzahl in Klammern.
4. Unter Manuelle KPIs zeigt jede Zeile den Namen, den Zielwert mit Einheit, den Richtungspfeil und Letzter Wert. Tipp deine Zahl rechts ins Feld.
5. Speichere entweder die einzelne Zeile — der Haken-Button neben dem Feld — oder alle gefüllten Zeilen auf einmal mit Alle Einträge speichern unten.

Eine gespeicherte Zeile leuchtet zwei Sekunden grün auf, und neben dem Button erscheint Gespeichert um HH:MM. Leere Zeilen werden stillschweigend übersprungen; eine gefüllte Zeile mit unlesbarem Inhalt wird gemeldet: „1 Wert war keine gültige Zahl und wurde übersprungen“.

Zahlenformate: 2,5, 2.5, 1.234,56 und 1,234.56 werden alle korrekt gelesen. Der wirklich mehrdeutige Fall — ein Trennzeichen gefolgt von genau drei Ziffern, etwa 2.810 — wird über die App-Sprache aufgelöst: Auf Deutsch ist der Punkt ein Tausendertrennzeichen, auf Englisch ist es das Komma.

Manuelle Zeilen füllen sich nie mit einem Wert vor, den du für diesen Tag schon gespeichert hast, und der Abschnitt Automatische KPIs zeigt immer die heutigen Werte, auch wenn du ein früheres Datum wählst. Das Datumsfeld steuert, wohin ein neuer Wert geschrieben wird — nicht, was die Seite anzeigt.

Der andere Weg: über die KPI-Seite

Klick die Karte an, um den KPI zu öffnen, und drück oben auf Wert eintragen. Das schreibt auf das heutige Datum. Um einen älteren Tag zu korrigieren, scroll zur Tabelle Verlauf und nutze den Stift in der betreffenden Zeile.

Du kannst für denselben KPI mehrere Werte am selben Tag erfassen — auf der Festplatte wird nichts überschrieben, aber für Diagramme, Status und alle Vergleiche zählt der jüngste Eintrag des Tages.

Mehr unter Werte erfassen.

Die Karte lesen

Nimm einen unternehmensweiten KPI namens Monatsumsatz: Einheit EUR, Zielwert 8000, Höher ist besser, Zeitraum Monat, Typ Kumulatives Ziel. Es ist der 10. Juli, und du hast gerade 3200 erfasst.

Die Karte zeigt jetzt von oben nach unten:

• Name und Status-Punkt. Der Punkt ist grün (Im Plan), gelb (Gefährdet) oder rot (Aus dem Plan).
• Den Wert, groß, mit der Einheit daneben: 3.200 EUR. Beträge in EUR, USD, GBP, CHF, € und $ werden ab 1.000 ohne Nachkommastellen gezeigt, darunter mit genau zweien.
• Das Abstands-Badge, z. B. +38% vs. Ideal. Das ist dein Abstand zu dem Punkt, an dem die Referenzlinie heute steht. Grün wenn du vorn liegst, gelb bei weniger als 10 % Rückstand, rot ab 10 %.
• Das Wochen-Badge, z. B. +12% vs. Vorwoche — der jüngste Wert gegen den neuesten Wert, der mindestens sieben Tage älter ist. Es fehlt schlicht, solange der KPI keine zwei ausreichend weit auseinanderliegenden Tage hat.
• Die Sparkline über den gesamten Zeitraum (hier 1.–31. Juli), deine Werte als gefüllte Linie, die Referenzlinie grau gestrichelt.
• Die Fußzeile: links 8.000 EUR/Monat, rechts ideal: 2.323 EUR.

Woher kommen die 2.323? Seit dem 1. Juli sind neun Tage vergangen, und 8.000 ÷ 31 × 9 = 2.322,58. Mit erfassten 3.200 liegst du 877,42 über dieser Linie, also +38 %, also grün.

Bei einem KPI vom Typ Wiederkehrender Wert steht in der Fußzeile Ziel: statt ideal: und im Badge vs. Ziel, weil die Referenzlinie flach auf dem Zielwert liegt.

Was die Zahlen am ersten Tag bedeuten

Am ersten Tag eines kumulativen Zeitraums steht die Referenzlinie exakt auf 0. Deshalb blendet die Karte das Abstands-Badge aus, und jeder nicht-negative Wert gilt als „Im Plan“. Das ist Arithmetik, kein Optimismus — aussagekräftig wird die Linie ab Tag zwei.

Ein KPI ganz ohne Werte zeigt einen Gedankenstrich, einen neutralen grauen Punkt und den Hinweis Heute eintragen.

Der vollständige Aufbau steht unter Dashboard und KPI-Detailseite; die Bewertungsregeln unter Ideal-Linie & Status.

Ein Connector-KPI in sechs Schritten

Ein Connector-KPI zieht seine Zahl aus einem Dienst, den du ohnehin nutzt — Google Search Console, Google Analytics 4, Plausible, Polar, Stripe oder Awin. Es ist derselbe Dialog, nur mit zwei zusätzlichen Auswahlschritten davor.

1. Klick wie gehabt auf + KPI und wähle die Karte Connector. Die Connector-Library öffnet sich von selbst.
2. Suche, oder klick links einen Dienst und rechts eine seiner Metriken an. Dann Ausgewählte Metrik verwenden.
3. Pulsaria fragt nach einer Verbindung — den Zugangsdaten für diesen Dienst. Wähle eine bestehende, oder klick Neue Verbindung anlegen und durchlaufe den kurzen Verbindungs-Assistenten. Keys und Service-Account-Dateien landen im macOS-Schlüsselbund, nicht in Pulsarias eigenen Dateien.
4. Zurück im KPI-Dialog hat die Metrik Einheit, Richtung, KPI-Typ und — sofern die Metrik sie vorgibt — Zeitraum und Cron-Zeitplan gefüllt. Der Name wird nur gefüllt, wenn du ihn leer gelassen hast.
5. Setze deinen Zielwert und den Bereich und prüfe den Cron-Zeitplan. Dieses Feld entscheidet, wann der Wert abgerufen wird.
6. Klick auf KPI anlegen.

Connector-KPIs brauchen keine Freigabe — anders als Bash- und HTTP-Quellen, bei denen du den exakten Befehl bzw. die URL erst ansiehst und freigibst, bevor sie je laufen.

Zwei Dinge, bevor du dich darauf verlässt. Ein Connector-KPI lässt sich auch ohne ausgewählte Metrik oder Verbindung speichern — das Formular prüft nur Name, Zielwert, Zeitraum und Cron — und ruft dann einfach nie etwas ab. Und ein KPI mit leerem Cron-Zeitplan wird vom Scheduler nie angefasst; er aktualisiert sich nur, wenn du am KPI Jetzt ausführen oder auf dem Dashboard Aktualisieren drückst.

Geplante Abrufe laufen, solange Pulsaria läuft. Alles zu Zugangsdaten, Metriken und den Eigenheiten der einzelnen Dienste steht unter Connectoren, alles zum Timing unter Zeitpläne & Aktualisierung.

Wie es weitergeht

• Aufbau eines KPI — jedes Feld, als Nachschlagewerk.
• Ideal-Linie & Status — warum eine Karte gelb ist und nicht grün.
• Datenquellen im Überblick — manuell, Connector, Shell oder HTTP, und wann was passt.
• Testphase & Lizenz — Anlegen und Bearbeiten setzt eine aktive Testphase oder Lizenz voraus; ohne beides tragen die meisten Buttons den Tooltip „Lizenz oder aktive Testversion nötig“.