# Anleitung schreiben

> Schreibe die Schritte zur Behebung einmal auf, ordne sie deinen Monitoren zu, und dein Team bekommt bei jedem Vorfall eine Checkliste.

Source: https://upfour.io/de/docs/write-a-playbook

Danach zeigt jeder Vorfall deines Monitors eine Checkliste mit den Schritten zur Behebung, und niemand muss sich erinnern, wie ihr es beim letzten Mal gelöst habt.

- **Wer:** Alle Rollen außer **Betrachter**
- **Dauer:** Etwa zehn Minuten
- **Was du brauchst:** Mindestens ein Monitor

Dem Monitor ordnest du die Anleitung zu.

**In up4:** Vorfälle › Anleitungen › Neue Anleitung · [In up4 öffnen](https://app.upfour.io/runbooks/new)

## Schritte

### 1. [Neue Anleitung beginnen](https://upfour.io/de/docs/write-a-playbook#start-playbook)

Öffne **Vorfälle**, wähle oben in der Liste **Anleitungen** und dann **Neue Anleitung**. Solange du noch keine geschrieben hast, steht an derselben Stelle **Anleitung anlegen**.

[![](https://upfour.io/docs/images/walk/de/write-a-playbook-start-playbook.webp)](https://upfour.io/docs/images/walk/de/write-a-playbook-start-playbook.webp)

### 2. [Benennen und Zuständigkeit festhalten](https://upfour.io/de/docs/write-a-playbook#name-playbook)

Gib einen **Titel** ein, etwa die Störung, die sie abdeckt. Unter **Beschreibung** schreibst du, wann sie gilt. Die ersten Zeilen erscheinen am Vorfall.

**Zuständig** ist freier Text, zum Beispiel ein Teamname. Er sagt, wer die Anleitung aktuell hält.

[![](https://upfour.io/docs/images/walk/de/write-a-playbook-name-playbook.webp)](https://upfour.io/docs/images/walk/de/write-a-playbook-name-playbook.webp)

### 3. [Schritte hinzufügen](https://upfour.io/de/docs/write-a-playbook#add-steps)

Wähle **Schritt hinzufügen**. Gib jedem Schritt einen **Schritttitel** und, wenn nötig, genaue Hinweise. Schreibe Schritte, denen ein müder Mensch nachts um vier folgen kann: je eine Handlung, in der richtigen Reihenfolge.

Zum Umsortieren öffnest du das Menü eines Schritts (**Aktionen für Schritt 2**) und wählst **Nach oben** oder **Nach unten**. Mindestens ein Schritt braucht einen Titel.

[![](https://upfour.io/docs/images/walk/de/write-a-playbook-add-steps.webp)](https://upfour.io/docs/images/walk/de/write-a-playbook-add-steps.webp)

### 4. [Monitore zuordnen](https://upfour.io/de/docs/write-a-playbook#link-monitors)

Hake unter **Verknüpfte Monitore** die Monitore an, zu denen die Anleitung gehört. Bei mehr als acht Monitoren hilft ein Suchfeld. Öffnet sich ein Vorfall an einem zugeordneten Monitor, erscheint die Checkliste dort.

[![](https://upfour.io/docs/images/walk/de/write-a-playbook-link-monitors.webp)](https://upfour.io/docs/images/walk/de/write-a-playbook-link-monitors.webp)

### 5. [Anleitung anlegen](https://upfour.io/de/docs/write-a-playbook#create-playbook)

Wähle **Anleitung anlegen**. Zum späteren Ändern öffnest du sie, wählst **Bearbeiten** und dann **Änderungen speichern**.

[![](https://upfour.io/docs/images/walk/de/write-a-playbook-create-playbook.webp)](https://upfour.io/docs/images/walk/de/write-a-playbook-create-playbook.webp)

## So siehst du, dass es geklappt hat

Die Anleitung steht mit ihrer Schrittzahl in der Liste. Beim nächsten Vorfall eines zugeordneten Monitors zeigt die Seitenleiste die **Checkliste der Anleitung** mit allen Schritten, ihren Hinweisen und einem Fortschrittsbalken.

Wer am Vorfall arbeitet, kann Schritte abhaken. up4 zeigt, wer wann abgehakt hat, und trägt es in den Verlauf des Vorfalls ein. Die Seite der Anleitung selbst bleibt eine Vorlage ohne Haken.

## Wenn etwas nicht stimmt

Am Vorfall erscheint keine Checkliste.

Der Vorfall muss zu einem Monitor gehören, dem eine Anleitung zugeordnet ist. Vorfälle ohne Monitor und die Vorfälle Geplanter Aufgaben haben keine. Siehe [Vorfall bearbeiten](https://upfour.io/de/docs/handle-an-incident.md).

Ein Monitor fehlt in der Liste.

Sind Kunden aktiviert, müssen Anleitung und Monitor zum selben Kunden gehören oder beide auf Unternehmensebene liegen.

Es erscheint die falsche Anleitung.

Sind einem Monitor mehrere Anleitungen zugeordnet, zeigt der Vorfall nur die erste, nach Titel sortiert. Ordne jedem Monitor eine Anleitung zu.

## Was up4 hier nicht macht

- Anleitungen lassen sich nur Monitoren zuordnen, nicht Alarmplänen oder Geplanten Aufgaben.
- Schritte sind reiner Text. Sie führen nichts aus, und Links darin sind nicht anklickbar.
- Beim Speichern einer Anleitung werden ihre Schritte ersetzt, und damit verschwinden die Haken aller Vorfälle, die sie genutzt haben. Ändere Anleitungen, wenn kein Vorfall offen ist.
- Die Haken gehören zum Vorfall, nicht zur Anleitung. Alle, die am Vorfall arbeiten, sehen dieselben Haken.
- Die Checkliste ist für dein Team. Im Kundenportal wird sie nicht angezeigt.

[Per API POST /v1/runbooks](https://upfour.io/docs/api/runbooks#post_runbooks)

Das Abhaken eines Schritts an einem Vorfall ist eine eigene Anfrage an die Anleitung. Beim Aktualisieren sendest du alle Schritte erneut.

| In der App | API-Feld |
| --- | --- |
| Titel | `title` |
| Beschreibung | `description` |
| Zuständig | `owner` |
| Schritte · eine Liste von Schritten mit Titel und Beschreibung | `steps` |
| Verknüpfte Monitore | `monitor_ids` |

[Vollständige Referenz (Englisch)](https://upfour.io/docs/api/runbooks#post_runbooks)