# Watchdog

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/watchdog/

_Benötigt Symcon >= 5.1_

Überprüft ob in einer Liste definierte Variablen überfällig sind. Sind Variablen überfällig, wird ein Alarm gesetzt und eine Liste dieser in der Visualisierung angezeigt.

### Funktionsumfang
- Überwachen von gelisteten Variablen.
- Einstellbarkeit ob die Variablen auf Änderung oder Aktuallisierung geprüft werden sollen.
- Einstellbarkeit wie lange die gelisteten Variablen überfällig sein dürfen.
- Ein-/Ausschaltbarkeit via Visualisierungsbutton oder Skript-Funktion.
- Anzeige wann die gelisteten Variablen zuletzt überprüft wurden.
- Darstellung des Originalpfades oder eines inndividuellen Namens.

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das Modul Watchdog installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Watchdog'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)
- Alle zu schaltenden Variablen müssen der Liste "Variablen" in der Instanzkonfiguration hinzugefügt werden.

#### Konfigurationsseite:

| Name      | Beschreibung                                                           |
| --------- | ---------------------------------------------------------------------- |
| Variablen | Dieser Liste werden die zu beobachtenden Variablen hinzugefügt.        |
| Zeit      | Dauer der Inaktivität bis die gelisteten Variablen den Alarm auslösen. |
| Einheit   | Einheit der Zeit.                                                      |

Sollten Variablen unterschiedlich lange erlaubt Inaktivität haben, ist es zu empfehlen mehrere Instanzen des Watchdog-Moduls zu verwenden.

### Statusvariablen
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

| Name               | Typ     | Beschreibung                                                                              |
| ------------------ | ------- | ----------------------------------------------------------------------------------------- |
| Aktive Alarme      | String  | Beinhaltet die Tabelle für die Darstellung in der Visualisierung.                         |
| Alarm              | Boolean | Die Variable zeigt an ob ein Alarm vorhanden ist. True = Alarm; False = OK;               |
| Letzte Überprüfung | Integer | UnixTimestamp der den Zeitpunkt angibt zu dem zuletzt überprüft wurde.                    |
| Watchdog aktiv     | Boolean | Zeigt an ob der Watchdog aktiviert ist oder nicht. True = Aktiviert; False = Deaktiviert; |

### Visualisierung
Über die Visualisierung kann der Watchdog de-/aktiviert werden.
Es wird zusätzlich die Information angezeigt, zu welchem Zeitpunkt zuletzt überprüft wurde.

## WD_GetAlertTargets

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/watchdog/wd-getalerttargets/

`array WD_GetAlertTargets(int $InstanzID)`

_Benötigt Symcon >= 5.1_

gibt ein Array mit den überfälligen Variablen zurück

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (array): Array der aktiven Alarme der Watchdoginstanz mit der InstanzID **InstanzID**

ID der Instanz

**Beispiel**

```text
WD_GetAlertTargets(12345);
```

## WD_SetActive

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/watchdog/wd-setactive/

`bool WD_SetActive(int $InstanzID, bool $SetActive)`

_Benötigt Symcon >= 5.1_

De-/aktiviert die Instanz

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$SetActive` (bool): Aktiviert/ Deaktiviert den Watchdog

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Aktiviert/ Deaktiviert den Watchdog

**Beispiel**

```text
WD_SetActive(12345, true);
```