Run-URLs

Run-URLs sind konfigurierbare Links, die fuer jeden Host in der Tabelle als Schnellzugriff verfuegbar sind. Sie koennen Variablen enthalten, die dynamisch durch Host-Daten ersetzt werden.

Konzept

Eine Run-URL ist ein URL-Template mit Platzhaltern. Wenn Sie auf die URL klicken, werden die Platzhalter durch die tatsaechlichen Werte des Hosts ersetzt und die URL im Browser geoeffnet.

Beispiel:

https://monitoring.firma.de/host/{hostname}

Wird fuer den Host "web01" zu:

https://monitoring.firma.de/host/web01

Run-URLs verwalten

Die Verwaltung erreichen Sie ueber Einstellungen > Run-URLs.

Run-URL erstellen

1. Klicken Sie auf Run-URL hinzufuegen
2. Konfigurieren Sie:

Feld	Beschreibung
Name	Bezeichnung (wird als Button/Link angezeigt)
URL-Template	URL mit {variable} Platzhaltern
Module	Fuer welche Module die URL angezeigt wird
Icon	Symbol fuer die Anzeige (siehe Icon-Liste unten)
Sortierung	Reihenfolge in der Anzeige (aufsteigend)
Aktiviert	Ein/Aus-Schalter fuer die Run-URL

Verfuegbare Platzhalter

Syntax

Die korrekte Platzhalter-Syntax verwendet einfache geschweifte Klammern: {varname} (nicht ).

Allgemeine Variablen (alle Module)

Platzhalter	Beschreibung	Beispiel
{id}	Interne Host-ID	42
{name}	Anzeigename des Hosts	Webserver 01
{hostname}	Hostname des Systems	web01
{ip_address}	IP-Adresse	192.168.1.10
{description}	Beschreibung des Hosts	Hauptwebserver
{agent_version}	Agent-Version	1.3.0
{serial_number}	Hardware-Seriennummer	ABC123XYZ
{customer_name}	Kundenname	Firma GmbH
{customer_number}	Kundennummer	K-001
{customer_id}	Interne Kunden-ID	5
{site}	Standort	Rechenzentrum A
{external_ip}	Externe/WAN-IP	203.0.113.1
{uptime}	Betriebszeit in Sekunden	86400
{cpu_usage}	CPU-Auslastung in Prozent	45
{memory_usage}	RAM-Auslastung in Prozent	72
{disk_usage}	Festplattenauslastung in Prozent	58
{pending_updates}	Anzahl ausstehender Updates	3

Modul-spezifische Variablen

Platzhalter	Module	Beschreibung
{opnsense_version}	OPNsense	OPNsense-Version
{firmware_version}	OPNsense	Firmware-Version
{pve_version}	PVE	Proxmox VE-Version
{pbs_version}	PBS	PBS-Version
{kernel_version}	PVE, PBS, Linux	Kernel-Version
{distribution}	Linux	Distribution (z.B. Ubuntu 22.04)
{os_version}	Windows	Windows-Version
{domain}	Windows	Active Directory-Domain
{windows_display_version}	Windows	Windows Build-Nummer
{windows_product_type}	Windows	Server / DC / Workstation
{rustdesk_id}	Windows	RustDesk-ID (falls installiert)

Tipp

Nicht alle Variablen sind fuer jeden Host befuellt. Wenn ein Wert nicht vorhanden ist, wird der Platzhalter durch einen leeren String ersetzt.

Verfuegbare Icons

Fuer die visuelle Kennzeichnung stehen 14 Icons zur Auswahl:

Icon	Name	Typischer Einsatz
↗️	ExternalLink	Externe Links (Standard)
🌐	Globe	Webanwendungen
🔗	Link	Allgemeine Links
🖥️	Monitor	Monitoring
🔍	Search	Suchsysteme
🛡️	Shield	Sicherheits-Tools
💻	Terminal	CLI/SSH-Zugriff
🗄️	Database	Datenbanken
🖧	Server	Server-Management
☁️	Cloud	Cloud-Dienste
🔑	Key	Zugangsverwaltung
✉️	Mail	E-Mail-Systeme
👁️	Eye	Ueberwachung
📊	BarChart3	Statistiken/Dashboards

Modul-Filter

Run-URLs koennen auf bestimmte Module beschraenkt werden:

• Alle - Erscheint bei allen Host-Typen
• OPNsense - Nur im OPNsense-Modul
• Proxmox VE - Nur im PVE-Modul
• Proxmox PBS - Nur im PBS-Modul
• Linux - Nur im Linux-Modul
• Windows - Nur im Windows-Modul

Mehrfachauswahl ist moeglich - eine URL kann z.B. nur fuer PVE und PBS gelten.

Verwendung

Im Kontextmenue

Rechtsklick auf einen Host zeigt die konfigurierten Run-URLs als Untermenue unter "Run-URL":

• Nur aktive (enabled: true) URLs werden angezeigt
• Nur URLs, die fuer das aktuelle Modul konfiguriert sind
• Sortiert nach der konfigurierten Sortierreihenfolge
• Jede URL zeigt das konfigurierte Icon

URL-Oeffnung

Beim Klick auf eine Run-URL:

1. Alle {variable} Platzhalter werden durch die Werte des Hosts ersetzt
2. Die fertige URL wird in einem neuen Browser-Tab geoeffnet

Praxisbeispiele

Monitoring-System

Name: Grafana
URL: https://grafana.firma.de/d/host?var-host={hostname}
Module: Alle
Icon: BarChart3

Ticketsystem

Name: Neues Ticket
URL: https://tickets.firma.de/new?host={hostname}&customer={customer_name}
Module: Alle
Icon: ExternalLink

WebUI-Zugriff

Name: PVE WebUI
URL: https://{ip_address}:8006
Module: PVE
Icon: Monitor

GLPI Asset-Suche

Name: GLPI Asset
URL: https://glpi.firma.de/front/computer.php?search={serial_number}
Module: Alle
Icon: Search

RustDesk Remote-Zugriff

Name: RustDesk
URL: rustdesk://{rustdesk_id}
Module: Windows
Icon: Monitor

Wiki-Eintrag

Name: Wiki
URL: https://wiki.firma.de/hosts/{hostname}
Module: Alle
Icon: Globe

Integration

Run-URLs eignen sich hervorragend, um DATAZONE Control mit anderen Tools Ihrer IT-Infrastruktur zu verknuepfen - Monitoring, Ticketsysteme, Wikis, Asset-Management, Konfigurationsmanagement und mehr.