> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serviceplan-agents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wenn etwas schiefgeht

> Welche Probleme die Console meldet, was eine Störungs-E-Mail sagt und mit welchem Button du jedes Problem behebst.

> [!NOTE]
>
> **Kurz gesagt:** Probleme erscheinen auf der Seite des Dashboards unter **Needs your attention** und im Reiter **History** unter den Hinweisen. Zusätzlich erhält die verantwortliche Person (Owner) eine E-Mail. Jeder Hinweis nennt Zeitpunkt und Ursache und bietet eine passende Aktion an.

## Was die Console meldet

**Needs your attention** im Reiter **Overview** sammelt alle Punkte, bei denen du handeln solltest. Zu jedem Punkt gibt es einen Button, mit dem du direkt reagierst.

| Problem | Was passiert ist | Button |
| - | - | - |
| **Keine neuen Daten** | Ein Datenbereich hat keine neuen Daten erhalten. Er zeigt **Overdue**. | **Resume updates**, **Start updates** oder **Refresh now** |
| **Daten, die ein Abschnitt nicht anzeigen kann** | Der Abschnitt behält seine letzten Daten. Alle anderen Abschnitte bleiben aktuell. | **Order the fix**: Alex erhält alle Informationen, die er zur Behebung braucht. |
| **Anzeigefehler** | Die tägliche Anzeigeprüfung hat einen Fehler erkannt. | **Order a fix**: Du beauftragst Alex, den Fehler zu beheben. |
| **Laufzeit endet bald** | Das Dashboard hat länger keine Aktualisierung erhalten. | **Extend by 90 days**: Die Laufzeit verlängert sich um weitere 90 Tage. |

Die Punkte dort warten auf eine Entscheidung von dir. Lässt du einen liegen, beschädigt das das Dashboard nicht.

> [!NOTE]
>
> **Screenshot nötig:** der Bereich „Needs your attention“ mit einem Hinweis und seinem Button.

## Die tägliche Anzeigeprüfung

Frische Daten helfen nicht, wenn das Dashboard sie nicht anzeigen kann. Neue Zahlen können eine Seite, die gestern noch funktionierte, manchmal stören. Deshalb wird jedes Live-Dashboard täglich so geöffnet, wie Leser:innen es sehen. Dabei wird nach Fehlern und nach Abschnitten gesucht, die nicht geladen wurden.

Die Prüfung kostet dich nichts. Es werden keine Credits verbraucht und kein Coworker eingesetzt.

```mermaid theme={"dark"}
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#FFF5F5','primaryBorderColor':'#FF4B4F','primaryTextColor':'#141414','lineColor':'#FF4B4F','tertiaryColor':'#ffffff','fontSize':'14px'}}}%%
flowchart LR
    A["Tägliche Prüfung<br/>öffnet dein Dashboard"] --> B{"Wird es<br/>richtig angezeigt?"}
    B -->|"Ja"| C["Nichts passiert"]
    B -->|"Nein"| D["Hinweis in der Console<br/>und Störungs-E-Mail"]
    D --> E["Du beauftragst<br/>die Korrektur"]
```

## Die Störungs-E-Mail

Der Betreff beginnt mit **Störung** (deutsch) oder **Incident** (englisch), zum Beispiel `Störung: Dashboard „Wettbewerber-Radar“ wird nicht vollständig angezeigt`. Die E-Mail ist in der Sprache deines Dashboards geschrieben. Sie hat diese Teile:

> [accordion] Störung
>
> Was passiert ist. Entweder wurde die Seite nicht fertig geladen, oder ein Teil davon hatte einen Fehler. Die E-Mail sagt dazu, dass die Daten selbst in Ordnung sind.

> [accordion] Auswirkung
>
> Was deine Leser:innen sehen: eine leere Seite, nur einen Teil des Dashboards oder einen genannten Abschnitt, der leer ist oder fehlt.

> [accordion] Seit
>
> Der Zeitpunkt der ersten fehlgeschlagenen Prüfung.

> [accordion] Nächste Schritte
>
> Eine Empfehlung und eine kurze Liste dessen, was du tun kannst.

> [accordion] Technische Details
>
> Fehlertexte für die Personen, die den Fehler beheben. Diesen Teil kannst du überspringen.

### Was die Empfehlung bedeutet

> [tab] Korrektur beauftragen
>
> Das Dashboard selbst hat einen Fehler. Er behebt sich nicht von allein. Öffne die Seite des Dashboards und klicke unter **Needs your attention** auf **Order a fix**. Die Kostenschätzung siehst du, bevor du bestätigst. Das ist der häufigste Fall.

> [tab] Abwarten
>
> Die Seite wurde nicht geladen. Das kann ein kurzer Aussetzer gewesen sein. Tu heute nichts. Am nächsten Tag wird erneut geprüft. Besteht das Problem dann noch, lautet die Empfehlung, eine Korrektur zu beauftragen.

> [!NOTE]
>
> In der E-Mail heißt die Funktion „Änderung anfordern“ (englisch „Request a change“). In der Console nutzt du **Order a fix**. Alternativ beschreibst du das Problem selbst über **Ask for a change**.

### Wie oft du davon hörst

* **Einmal**, wenn ein Problem zum ersten Mal auftritt.
* **Nicht noch einmal**, solange es andauert, auch wenn die Prüfung weiter fehlschlägt.
* **Eine Erinnerung nach 7 Tagen**, wenn es immer noch besteht.

Ist das Dashboard bei der nächsten Prüfung wieder in Ordnung, erhältst du dazu keine eigene E-Mail. Öffne das Dashboard und sieh nach, ob es wieder funktioniert.

> [!TIP]
>
> Bei einem Test-Dashboard musst du nichts tun. Das sagt auch die E-Mail.

## Wenn ein Datenbereich ausbleibt

Kommt ein Datenbereich nicht in seinem Rhythmus, zeigt er in der Tabelle **Data** den Status **Overdue**. Eine kurze Verspätung löst noch nichts aus. Bleibt der Bereich länger aus, erhält die verantwortliche Person eine E-Mail („A data feed of … has gone quiet“). Sie nennt den Bereich und sagt, wie alt die Zahlen sind. Das Dashboard bleibt online.

Unter **Needs your attention** steht dann der passende Button:

* **Resume updates**, wenn die Aktualisierung des Bereichs pausiert ist.
* **Start updates**, wenn sie nie gestartet wurde oder beendet ist.
* **Refresh now**, wenn die Aktualisierung läuft, aber keine neuen Daten kamen.

Ist ein Bereich bewusst abgeschlossen, etwa der Vergleichswert des Vorjahres, beendest du seine Aktualisierung mit **Stop expecting updates**. Siehe [Datenbereiche und Aktualisierung](https://docs.serviceplan-agents.com/de/live-apps/data-feeds.md).

## Wenn es die Daten nicht gibt

Coworker raten nie. Ein Beispiel: Du forderst den wöchentlichen Stromverbrauch je Region an. Hannah findet aber nur Monatswerte je Region. Statt Zahlen zu erfinden, meldet sie die Lücke und schlägt Monatswerte vor. Du hast dann drei Möglichkeiten:

* Du stimmst zu.
* Du stellst das Dashboard per Änderung auf Monatswerte um.
* Du schickst eine eigene Tabelle mit.

## Wie es weitergeht

> [card] [Eine Live-App anfordern](https://docs.serviceplan-agents.com/de/live-apps/ordering.md)
>
> Wie du eine Änderung anforderst.

> [card] [Support kontaktieren](mailto:support@serviceplan-agents.com)
>
> Unsicher, was ein Hinweis bedeutet? Schreib an [support@serviceplan-agents.com](mailto:support@serviceplan-agents.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.