Zum Hauptinhalt springen
Checks verwenden

Checks mit Konfigurationspaketen zuweisen

Paketmodule auswählen, Checks zuweisen und gerätespezifische Abweichungen prüfen.

Mit einem Konfigurationspaket weist du Monitoring-Checks vielen Geräten zu: Du legst die Checks und ihre Einstellungen einmal fest und bestimmst mit Regeln, welche Geräte sie erhalten. Diese Anleitung zeigt dir, wie du ein Paket aufbaust und die richtigen Geräte auswählst — von einem einzelnen Server bis zu allen Windows-Servern deiner Kunden.

Zwei Wege, einen Check zuzuweisen

VorgehenSo richtest du es einAm besten für
Direkt am GerätÖffne das Gerät, wechsle auf den Tab Checks und klicke auf Check hinzufügen.Ein einmaliger Check auf einem einzelnen Gerät.
Regelbasiertes KonfigurationspaketBaue ein Paket einmal auf und lass dann Zuweisungsregeln entscheiden, welche Geräte es erhalten.Denselben Satz von Checks über viele Geräte oder Kunden hinweg standardisieren.

Die beiden Wege ergänzen sich: Ein Gerät kann direkt zugewiesene Checks tragen und gleichzeitig auf mehrere regelbasierte Pakete passen — alle diese Checks laufen dann darauf. Diese Anleitung behandelt das regelbasierte Paket, denn so überwachst du beliebig viele Geräte, ohne sie einzeln zu bearbeiten.

Voraussetzungen

  • Die Berechtigung Monitoring-Check-Verwaltung, die über Gruppen unter Administration → Gruppen vergeben wird — siehe So funktionieren Benutzer, Gruppen & Berechtigungen. Mit dieser Berechtigung kannst du Konfigurationspakete erstellen und bearbeiten. Wenn du Konfiguration → Konfigurationspakete nicht siehst, bitte einen Administrator, sie dir zu vergeben.
  • Für tag-basierte Regeln sollten die Geräte, die du adressieren willst, die Tags, auf die du abgleichst, bereits tragen — siehe Tag-Regeln konfigurieren.

Ein gemeinsames Paket kann trotz dieser Berechtigung Schreibgeschützt sein, wenn du nicht auf alle betroffenen Kunden zugreifen darfst. Du kannst es dann ansehen, aber nicht ändern oder klonen; siehe Gemeinsam genutzte Konfigurationen.

Ein regelbasiertes Paket erstellen

Konfigurationspakete findest du unter Konfiguration → Konfigurationspakete, aufgeteilt in Regelbasierte Pakete und Direkt zugewiesene Pakete.

  1. Gehe zu Konfiguration → Konfigurationspakete und stelle sicher, dass der Tab Regelbasierte Pakete ausgewählt ist.
  2. Klicke auf Paket erstellen.
  3. Gib einen Namen ein (zum Beispiel Standard Server Checks) und optional eine Beschreibung, damit später nachvollziehbar ist, wofür das Paket gedacht ist. Um von einem bestehenden Paket auszugehen, wähle eines unter Klonen von; andernfalls belasse es auf Leeres Paket.
  4. Wähle für ein leeres Paket die Kunden aus. Ohne globalen Kundenzugriff ist diese Auswahl erforderlich. Beim Klonen wird der Kundenbereich der Vorlage übernommen.
  5. Wähle unter Module mindestens Checks für diese Anleitung. Zusätzlich kannst du Software, Agent-Einstellungen, Wartung und Automatisierungen aufnehmen. Regeln ist immer enthalten.
  6. Klicke auf Erstellen. Die Detailseite zeigt die ausgewählten Module als Tabs; Agent-Einstellungen öffnest du über Agent.

Du kannst auch auf Aus Vorlage starten klicken und eines der eingebauten Pakete als Ausgangspunkt wählen. Prüfe beim Klonen und bei Vorlagen ebenfalls die Module: Nur die ausgewählten Inhalte werden übernommen.

Eine Kopie ist kein Entwurf: Beim Klonen werden auch die Zuweisungsregeln übernommen. Prüfe und speichere zuerst die Regeln, bevor du Checks für eine andere Gerätegruppe änderst. Gespeicherte Änderungen können bereits auf den bisher passenden Geräten ausgeführt werden. Wenn schon die kopierten Inhalte dort nicht laufen dürfen, wähle Leeres Paket und richte zuerst dessen Zielgruppe ein.

Module und Software-Zeitplan verwalten

Öffne Module bearbeiten, wähle die gewünschten Module und klicke auf Übernehmen. Entfernst du ein Modul mit vorhandenen Einstellungen, bestätige Einstellungen verwerfen nur, wenn du sie wirklich löschen möchtest. Speichere danach das Paket.

Beim Speichern werden die Einstellungen entfernter Module dauerhaft gelöscht. Software entfernt auch den Deployment-Zeitplan, Automatisierungen die Verknüpfungen dieses Pakets — nicht die Automatisierungsdefinitionen selbst. Das ist mehr als das Ausblenden eines Tabs.

In der Paketliste zeigt Module den Inhalt; Nach Modul filtern... kannst du mit der Textsuche kombinieren. Deployment-Zeitplan zeigt den Zeitplan für Softwareverteilungen und bleibt ohne hinterlegten Zeitplan leer. Er ist unabhängig von den Zeitplänen der Automatisierungen.

Checks zum Paket hinzufügen

  1. Suche auf dem Tab Checks des Pakets den Abschnitt Enthaltene Checks und klicke auf Check hinzufügen.
  2. Wähle einen Check-Typ und lege seine Schwellenwerte fest. Anleitungen, Felder und Standardwerte für jeden einzelnen Check findest du in der Seitenleiste unter Checks.
  3. Wiederhole das für jeden Check, den dieses Paket tragen soll. Ein Paket kann so viele Checks bündeln, wie du brauchst; sie werden alle gemeinsam zugewiesen, sobald das Paket auf ein Gerät passt.

Checks mit gerätespezifischen Feldern (Host, Zugangsdaten)

Ein Paket enthält eine Konfiguration für alle passenden Geräte. Bei angelegten Netzwerkgeräten erhalten unterstützte Checks Host/IP und SNMP-Verbindungseinstellungen automatisch vom Gerät. Das gilt nicht für alle Zugangsdaten: Der OPNsense-Check benötigt weiterhin einen eigenen API-Key und ein API-Secret, der ESXi-Check eigene Zugangsdaten — auch wenn diese bereits am Gerät hinterlegt sind.

  • Bei einer Handvoll Appliances mit individuellen Zugangsdaten füge die Checks direkt auf dem jeweiligen Gerät hinzu.
  • Wenn du sie über ein Paket zuweist, trage die gerätespezifischen Zugangsdaten auf jedem Gerät über Für dieses Gerät überschreiben im Monitoring-Checks-Bereich ein. Das Überschreiben entkoppelt auch die übrigen Check-Felder einschließlich der Schwellenwerte von künftigen Paket-Änderungen — über das Override-Badge im Checks-Tab des Pakets bleiben sie auffindbar.

Agent-Einstellungen für alle Geräte festlegen (optional)

Über Checks und Software hinaus kann ein Paket auch Agent-Einstellungen auf jedes Gerät anwenden, das es erfasst. Öffne den Tab Agent des Pakets und aktiviere die gewünschten Einstellungen. Der effektive Wert eines Geräts kombiniert alle seine Pakete, und du kannst jede Einstellung pro Gerät auf der Geräteseite überschreiben.

EinstellungWas sie bewirkt
Benutzerzustimmung für Remotedesktop erforderlichErfasste Geräte fordern den angemeldeten Benutzer auf, jede Remotedesktop-Sitzung vor dem Start zu erlauben.
Zugriff auf die physische Konsole auf Terminalservern ohne Zustimmung erlaubenÜberspringt die Abfrage nur für eine Windows-Sitzung an der physischen Konsole. RDP-Sitzungen erfordern weiterhin eine Zustimmung. Die Einstellung sitzt unter Benutzerzustimmung für Remotedesktop erforderlich und lässt sich nur aktivieren, solange diese aktiv ist.
Agent-Symbol im Traybereich anzeigenDas octoja-Agent-Symbol im Traybereich erfasster Geräte anzeigen.
Software-Kiosk aktiviertBenutzern auf erfassten Geräten erlauben, freigegebene Software aus dem Self-Service-Kiosk zu installieren.
Ticketing aktiviertBenutzern auf erfassten Geräten erlauben, Support-Fälle zu erstellen.
Automatisch sperren nach RemotedesktopErfasste Geräte sperren automatisch, wenn eine Remotedesktop-Sitzung endet. Techniker können dies pro Sitzung weiterhin übersteuern.
Nur während einer Remotedesktop-Sitzung zulassenBeschränkt den Datei-Explorer auf aktive Remotedesktop-Sitzungen desselben Technikers und Geräts. Die Einstellung erteilt keine Berechtigung: Der Techniker benötigt weiterhin die erlaubten Aktionen Dateibrowser und Remotedesktop.
Lokale Deinstallation verhindernErfasste Geräte blenden den Agent aus „Programme und Features“ aus, sodass Benutzer ihn nicht mit einem Klick deinstallieren können. Die Entfernung bleibt möglich, indem das Gerät in octoja gelöscht wird.

Nur während einer Remotedesktop-Sitzung zulassen ist standardmäßig deaktiviert. Solange die Einstellung aktiv ist, sind Dateioperationen über MCP nicht verfügbar, weil sie nicht an eine interaktive Remotedesktop-Sitzung gebunden werden können.

Mit Zuweisungsregeln die richtigen Geräte adressieren

Zuweisungsregeln entscheiden, für welche Geräte das Paket gilt. Öffne den Tab Regeln des Pakets.

Auf dem Tab Rules bleibt die Kundenauswahl leer. Im Regel-Builder wird Device Class und dann Windows Server gewählt; die Trefferliste zeigt zwei Server. Ein Klick auf Save öffnet die Bestätigung No customers selected mit dem Hinweis, dass die Regel für alle Kunden gilt.

  1. Wähle unter Kunden die Kunden aus, für die dieses Paket gelten soll. Nur mit globalem Kundenzugriff kannst du das Feld leer lassen, um das Paket auf alle Kunden anzuwenden.
  2. Formuliere unter Geräteregeln eine Bedingung in der Form Anwenden auf Geräte, bei denen <Feld> <Operator> <Wert> — zum Beispiel Geräteklasse ist Windows Server.
  3. Klicke auf Bedingung hinzufügen, um derselben Regel eine weitere Bedingung hinzuzufügen. Bedingungen innerhalb einer Regel werden mit und verknüpft (jede Bedingung muss zutreffen).
  4. Um ein oder auszudrücken (ein Gerät passt, wenn es irgendeine Regel erfüllt), füge eine zweite Regel hinzu oder beginne einen neuen Block mit oder alternativ.... Ein Gerät wird einbezogen, sobald eine Regel zutrifft.
  5. Klicke auf Speichern. octoja wertet die Regel neu aus und weist die Checks des Pakets passenden Geräten automatisch zu — oder entfernt sie.

Vervollständige oder entferne unvollständige Bedingungen und leere Gruppen vor dem Speichern. Ungültige gespeicherte Regeln erfassen keine Geräte, auch wenn eine andere Alternative passen würde. Prüfe deshalb immer die Trefferliste.

Das ist dieselbe Regel-Engine, die auch Tag-Regeln nutzen. Der einfache Satzbaukasten verarbeitet und/oder-Bedingungen; für verschachtelte Gruppen wechselt octoja in den Erweiterten Editor, wo du die Regel direkt in octoja Query Language (OQL) schreibst.

Regelfelder

FeldTrifft zu aufBeispiel
BetriebssystemDer Betriebssystem-Text des GerätsBetriebssystem enthält Windows
GeräteklasseDer klassifizierte GerätetypGeräteklasse ist Windows Server
TagsTags am GerätTags enthält database
Kunden-TagsTags am Kunden des GerätsKunden-Tags enthält managed
StandortDer Standort des GerätsStandort ist gleich Berlin Office
GerätenameDer HostnameGerätename beginnt mit SRV-
DomäneDie Domäne des GerätsDomäne ist gleich corp.example.com
HerstellerHardware-HerstellerHersteller enthält Dell
ModellHardware-ModellModell enthält PowerEdge
DienstEin Dienst im Inventar des GerätsDienst enthält MSSQLSERVER
AnwendungInstallierte SoftwareAnwendung enthält Microsoft SQL Server
OS-ArchitekturDie Architektur des BetriebssystemsOS-Architektur ist gleich Arm64
SeriennummerDie Seriennummer der HardwareSeriennummer beginnt mit CZC
GehäusetypDie Bauform der Hardware (Desktop, Laptop, Server, …)Gehäusetyp ist gleich Laptop
Hat AkkuOb das Gerät einen Akku hatHat Akku ist Ja
Agent-VersionDie auf dem Gerät installierte octoja-Agent-VersionAgent-Version beginnt mit 1.0.
MitgliedschaftWie das Gerät in ein Verzeichnis eingebunden ist — Arbeitsgruppe, Domäne, Azure AD oder HybridMitgliedschaft ist Domäne
Eigenes Feld (Gerät)Der Wert eines eigenen Gerätefelds, das du auswählst — wird erst angeboten, sobald mindestens ein eigenes Gerätefeld existiertEigenes Feld (Gerät) Kostenstelle ist gleich 4711
Eigenes Feld (Kunde)Der Wert eines eigenen Felds am Kunden des Geräts — wird erst angeboten, sobald mindestens ein eigenes Kundenfeld existiertEigenes Feld (Kunde) Vertragsstufe ist gleich Gold

Welche Operatoren verfügbar sind, hängt vom Feld ab: Textfelder bieten ist gleich, ist nicht gleich, enthält, enthält nicht, beginnt mit und beginnt nicht mit; Geräteklasse, Mitgliedschaft und Hat Akku nutzen ist und ist nicht; Tags und Kunden-Tags nutzen enthält, enthält nicht, passt auf Text und passt nicht auf Text. Bei den ersten beiden wählst du ein bestehendes Tag aus einer Liste; die letzten beiden nehmen freien Text und treffen auf einen Teil eines Tag-Namens, sodass eine Bedingung jedes Tag erfasst, das ein bestimmtes Wort enthält.

Die Werte für Geräteklasse sind Windows Server, Windows Workstation, Linux Server, Linux Desktop, macOS, Switch, Router, Firewall, Access Point, Drucker, NAS, USV, ESXi, vCenter und IP-Kamera.

Prüfen, ob die Regel die richtigen Geräte trifft

Während du die Regeln bearbeitest, zeigt octoja live, wie viele Geräte aktuell passen — zum Beispiel „12 Geräte zutreffend“ — über einer durchsuchbaren Liste genau dieser Geräte, die zu jedem Gerät Geräteklasse, Betriebssystem und Kunde anzeigt. So stellst du sicher, dass das Paket tatsächlich irgendwo landet.

  • Wenn du „Keine Geräte entsprechen diesen Regeln.“ siehst, ist das Paket gültig, läuft aber auf null Geräten — es liegt still da und überwacht nichts. Das ist kein Fehler, und du wirst später nicht darauf hingewiesen; lies also immer die Trefferzahl, bevor du dich auf ein Paket verlässt. Eine häufige Ursache ist ein Tag in der Regel, das noch kein Gerät trägt.
  • Wenn du mit globalem Kundenzugriff ohne ausgewählte Kunden speicherst, warnt octoja mit „Keine Kunden ausgewählt“ und weist dich darauf hin, dass die Regeln dann für Geräte aller Kunden gelten — bestätige nur, wenn du genau das beabsichtigst. Ohne globalen Zugriff musst du Kunden auswählen.

Du kannst das auch von der Geräteseite aus prüfen. Öffne ein Gerät, öffne sein Aktionsmenü und wähle Konfigurationspakete: Der Dialog listet jedes regelbasierte Paket auf, das dieses Gerät erreicht, mit seiner Beschreibung und seinem Inhalt — Checks, Software-Verteilungen, Automatisierungen oder Agent-Einstellungen — und ein Klick auf eine Zeile öffnet das Paket. Passt kein Paket, sagt der Dialog dir das und verweist auf den Tab Checks des Geräts, wo direkt zugewiesene Checks liegen.

Ein Paket über mehrere Kunden hinweg wiederverwenden

Ein regelbasiertes Paket ist nicht an einen einzelnen Kunden gebunden. Mit globalem Kundenzugriff kannst du das Feld Kunden leer lassen, und das Paket gilt für jeden Kunden in deiner Instanz — eine Regel wie Geräteklasse ist Windows Server deckt so alle Windows Server ab, die du verwaltest, aus einem einzigen Paket. Baue den Standard einmal auf, und jedes neue passende Gerät übernimmt ihn automatisch, sobald es sich das nächste Mal meldet.

Geräte finden, die einen Check des Pakets überschreiben

Ein einzelnes Gerät kann über sein eigenes Panel Monitoring-Checks aus der gemeinsamen Konfiguration herausgenommen werden — per Auf diesem Gerät deaktivieren, Für dieses Gerät anpassen oder über eine eigene Alarmkonfiguration (siehe Alarmierung für einen Check einrichten). Dieses Gerät behält dann seine eigenen Einstellungen und übernimmt die Änderungen, die du am Paket vornimmst, nicht mehr — über viele Geräte hinweg leicht aus dem Blick zu verlieren. Der Tab Checks des Pakets zeigt dir, wo das passiert ist.

Unter Enthaltene Checks trägt jeder Check, von dem mindestens ein Gerät abweicht, ein Badge — 3 Überschreibungen, oder 1 Überschreibung bei einem einzelnen Gerät. Klicke darauf, um Geräte-Überschreibungen für diesen Check zu öffnen: eine Liste aller betroffenen Geräte mit Kunde, Standort und Geräteklasse, jeweils markiert mit dem, was sie geändert haben.

Fahre über den Gerätenamen, um die Gerätevorschau zu sehen. Ein Klick auf den Namen öffnet das Gerät, damit du die Abweichung im Zusammenhang mit seinen Checks prüfen kannst.

MarkierungWas das Gerät geändert hat
DeaktiviertDer Check ist auf diesem Gerät pausiert — er läuft nicht und zeichnet keine Ergebnisse auf.
KonfigurationDas Gerät führt den Check mit eigenen Einstellungen aus — Schwellenwerte, Pfade, Zugangsdaten — statt mit denen des Pakets.
AlarmDas Gerät nutzt eine eigene Alarmkonfiguration oder hat Alarme abgeschaltet, statt der des Pakets.

Klicke in einer Zeile auf Änderungen, um genau zu sehen, was abweicht: jede geänderte Einstellung mit dem durchgestrichenen Wert des Pakets und dem Wert des Geräts daneben, und dieselbe Gegenüberstellung für die Alarmkonfiguration (Aus, wenn das Gerät Alarme abgeschaltet hat).

Um ein Gerät wieder auf die gemeinsame Konfiguration zu setzen, klicke in seiner Zeile auf Rückgängig — das räumt alle drei Arten auf einmal ab, sodass ein dort deaktivierter Check auch wieder zu laufen beginnt. Alle rückgängig setzt nach einer Bestätigungsabfrage jedes Gerät in der Liste zurück. In beiden Fällen benachrichtigt octoja die betroffenen Agents sofort, sodass die Konfiguration des Pakets wirksam wird, ohne auf den nächsten Check-in zu warten.

Tipps

  • Direkt zugewiesene Checks und regelbasierte Pakete addieren sich auf einem Gerät — nutze die direkte Zuweisung für Ausnahmen und Pakete für den Standard.
  • Alarmregeln liegen am Check innerhalb des Pakets, sodass ein Paket sowohl den Check als auch die Art deiner Benachrichtigung bei einem Fehlschlag tragen kann — siehe Alarmierung für einen Check einrichten.
  • Nutze die Live-Trefferzahl als Kontrolle nach jeder Regeländerung — ein unerwarteter Abfall auf null bedeutet meist, dass eine Bedingung jetzt zu streng ist oder ein Tag fehlt.
  • Starte aus einer eingebauten Vorlage, wenn du einen sinnvollen Standardsatz von Checks statt eines leeren Pakets möchtest.
  • Nutze den Tab Automatisierungen, um geplante Automatisierungen an ein regelbasiertes Paket zu hängen — sie laufen dann auf jedem Gerät, das das Paket erfasst.

FAQ

Öffne das Gerät und seinen Tab Checks. Du benötigst die Berechtigung Monitoring-Check-Verwaltung. Die passende Aktion hängt davon ab, wie der Check zugewiesen wurde:

ZuweisungVorgehen
Direkt am GerätKlicke beim Check auf den Papierkorb und bestätige Entfernen. Dabei wird auch sein Ergebnisverlauf auf diesem Gerät gelöscht.
Über ein regelbasiertes KonfigurationspaketNutze beim Check Auf diesem Gerät deaktivieren. Der Check läuft auf diesem Gerät nicht mehr; seine Zuweisung und der bisherige Verlauf bleiben erhalten. Über Auf diesem Gerät aktivieren kannst du ihn wieder einschalten.

Für eine Ausnahme auf nur einem Gerät musst du weder den Agenten deinstallieren noch das Gerät löschen. Ändere den Check oder die Regeln im gemeinsamen Paket nur, wenn die Änderung auch für die übrigen betroffenen Geräte gelten soll.

Die manuelle Neuausführung startest du am Check des jeweiligen Geräts; im Paket gibt es dafür keine flottenweite Schaltfläche. Beim Speichern geänderter Check-Eingaben werden die betroffenen Agents benachrichtigt. Ändern sich die tatsächlich verwendeten Eingaben eines Checks, läuft er nach Empfang der Konfiguration erneut. Offline-Geräte müssen sich zuerst verbinden; durch Geräteüberschreibungen können die wirksamen Eingaben unverändert bleiben. Ändere Schwellenwerte oder andere Einstellungen nicht nur, um eine Neuausführung zu erzwingen.

Ja. Die Zuweisung folgt den Paketregeln; der Agent führt einen Check ohne ausführbare Version für seine Plattform nicht aus. Das ist aber keine Prüfung aller Voraussetzungen: Ein grundsätzlich unterstützter Check kann trotzdem fehlschlagen, wenn etwa benötigte Software fehlt.

Nutze gemeinsame Pakete für gemeinsame Grundlagen und gezielte Geräteklassen- oder Betriebssystemregeln für plattformspezifische Anforderungen. Prüfe die Plattformangaben und Voraussetzungen jedes Checks; eine Zuweisung allein bestätigt nicht, dass er auf dem Gerät läuft.