MailStore (Server & SPE)

Der Check MailStore (Server & SPE) meldet die Anzahl archivierter Benutzer, wertet die Archivierungsprofil-Läufe aus und überwacht den Ablauf von TLS-Zertifikaten — die beiden letzten sind standardmäßig aktiviert. Das Feld Edition bestimmt das Produkt. MailStore SPE (Management-API) fragt die Management-API der Service-Provider-Edition (SPE) ab — kein Zugriff je Instanz erforderlich — und meldet eine Zahl je Instanz sowie eine deployment-weite Gesamtzahl; gestoppte Instanzen zählen weiterhin zur Gesamtzahl, wenn Lizenzdaten verfügbar sind. MailStore Server (Administrations-API) fragt einen einzelnen MailStore Server ab, der keine Instanzen kennt, und meldet eine einzige Zahl. Der Check läuft nur unter Windows (Server und Desktop) auf dem octoja-Agenten eines Hosts, der die MailStore-API erreichen kann, alle 360 Minuten (6 Stunden). Das Intervall ist nicht durch den Benutzer konfigurierbar.

Voraussetzungen

• MailStore SPE auf einem Windows-Server installiert
• Der octoja-Agent ist auf demselben Server installiert (oder auf einem Windows-Host, der die SPE-Management-API erreichen kann)
• Ein Management-API-Benutzer mit Berechtigung zum Auflisten von Instanzen und (optional) zum Abfragen von Benutzern, Profilen und Worker-Ergebnissen — erstelle ihn in SPE unter Verwaltungskonsole → Benutzerverwaltung
• Netzwerk-Erreichbarkeit vom Agenten zum SPE-Management-API-Host auf TCP/8474 (oder deinem konfigurierten Port)

Für MailStore Server (Administrations-API) brauchst du stattdessen einen MailStore-Administrator; die Administrations-API nutzt standardmäßig Port 8463.

Wo ist die Verwaltungskonsole? Suche auf dem SPE-Management-Host im Startmenü nach „MailStore SPE Management Console“. Dokumentation: help.mailstore.com (die frühere SPE-Wiki-Seite zur Management-API wurde eingestellt — starte im Dokumentationsportal).

Schritte

1. Stelle sicher, dass der octoja-Agent auf einem Windows-Gerät installiert ist, das die MailStore-API erreichen kann.
2. Gehe zu Geräte und öffne dieses Gerät.
3. Klicke auf den Tab Checks → Check hinzufügen → MailStore (Server & SPE).
4. Wähle die Edition — das erste Feld im Dialog. Für ein SPE-Deployment lässt du MailStore SPE (Management-API) stehen.
5. Trage Server, Port, Benutzername und Passwort ein und passe die Überwachungsoptionen an (siehe Einstellungen).
6. Klicke auf Check hinzufügen.

Nach dem ersten Check-Intervall siehst du das Ergebnis im Checks-Tab des Geräts mit der Gesamtsumme, einer Aufschlüsselung je Instanz (Name, Status, Benutzerzahl, Quelle), einem Abschnitt zu den Archivierungsprofilen (geprüfte und fehlgeschlagene Profile sowie je eine Zeile für jedes auffällige Profil) und einem Zertifikatsabschnitt, der jeden geprüften Endpunkt und dessen Restlaufzeit auflistet.

Einstellungen

Liegt die Warnschwelle (Tage) unter der Kritisch-Schwelle (Tage), vertauscht der Check beide Werte vor der Auswertung. Ein Rückblick-Zeitfenster (Stunden) unter 1 wird als 1 Stunde behandelt.

Ergebnisse

Das Gesamtergebnis des Checks ist der schlechteste Status über die Benutzerzahlen, die Archivierungsprofile und die überwachten Zertifikate hinweg.

• Erfolgreiche Archivierungsprofile werden mitgezählt, erscheinen aber nicht als einzelne Problemzeile im Ergebnis.
• HTTP-Timeout je API-Aufruf beträgt 30 Sekunden. Zusätzliche Zertifikats-Endpunkte werden mit einem Timeout von 10 Sekunden geprüft.
• Schlägt die Abfrage der Profil-Läufe (GetWorkerResults) für eine Instanz fehl, etwa weil dem API-Benutzer die Berechtigung fehlt, überspringt der Check die Archivierungsauswertung dieser Instanz, ohne dafür eine Warnung zu melden.
• In SPE unterscheidet ein erfolgreicher Lauf drei Quellen je Instanz: GetUsers ist die maßgebliche Live-Zahl für laufende Instanzen; License ist die usedLicenseCount je Instanz aus dem SPE-Lizenzbericht, als Fallback bei fehlgeschlagenem GetUsers; License(stopped) ist derselbe Fallback für gestoppte Instanzen.
• MailStore Server kennt keine Instanzen, daher meldet der Check eine einzige Zeile mit dem Namen des konfigurierten Servers, und die Zahl stammt immer aus GetUsers — einen Lizenz-Fallback gibt es dort nicht. Archivierungsprofil-Läufe und Zertifikatsablauf werden genauso ausgewertet wie in SPE.

Erfasste Metriken

Je Check-Lauf:

• totalUsers — Summe von userCount über alle Instanzen
• instanceCount — Anzahl der von GetInstances zurückgegebenen Instanzen; in der MailStore-Server-Edition immer 1
• profilesChecked — Archivierungsprofile, deren letzter Lauf über alle Instanzen hinweg ausgewertet wurde
• profilesFailed — davon die Anzahl mit kritischem letztem Lauf

Je Instanz:

• instanceId — SPE-Instanz-Identifikator; in der MailStore-Server-Edition leer
• name — Anzeigename der Instanz (fällt auf Alias und dann auf ID zurück); in der MailStore-Server-Edition der konfigurierte Server-Host
• status — Lebenszyklus-Status der Instanz aus SPE (z. B. Running, Stopped); in der MailStore-Server-Edition immer running
• userCount — archivierte Benutzerzahl, oder null wenn unbestimmbar
• source — wie die Zahl ermittelt wurde: GetUsers (laufend + API-Aufruf), License (laufend + Lizenz-Fallback), License(stopped) (gestoppt + Lizenz-Fallback), leer (unbestimmbar). Die beiden Lizenz-Werte gibt es nur in SPE

Je Archivierungsprofil — aufgeführt werden nur Profile, deren letzter Lauf nicht in Ordnung war; einwandfreie werden lediglich gezählt:

• instanceName — Instanz, zu der das Profil gehört
• profileName — Profilname aus GetProfiles, oder die Profil-ID, wenn der Name nicht aufgelöst werden konnte
• lastStatus — roher MailStore-Statuswert des letzten Laufs
• lastRunAt — Zeitstempel des letzten Laufs, oder null

Je geprüftem Zertifikats-Endpunkt:

• endpoint — geprüfter host:port
• notAfter — Ablaufzeitpunkt des Zertifikats, oder null wenn das Zertifikat nicht gelesen werden konnte
• daysRemaining — Tage bis zum Ablauf, nach Ablauf negativ
• unreachable — true, wenn der Endpunkt nicht erreichbar war oder kein Zertifikat vorgelegt hat

Datenschutz und Zugangsdaten

• Der Check verwendet HTTP-Basic-Authentifizierung. Die konfigurierten Zugangsdaten werden nur für die API-Aufrufe verwendet und erscheinen nie in der Check-Ausgabe.
• Der Check erfasst keine Benutzernamen, E-Mail-Adressen oder Archivinhalte — nur Anzahlen, Namen von Archivierungsprofilen samt Status ihres letzten Laufs sowie Daten zum Zertifikatsablauf.

Tipps

• Benutzerzahlen ändern sich in Archiv-Lasten langsam; das 6-Stunden-Intervall vermeidet unnötige Last auf dem SPE-Management-Host.
• Verwende einen dedizierten, schreibgeschützten Management-API-Benutzer für octoja. Falls die Zugangsdaten je kompromittiert werden, kannst du sie in der SPE-Verwaltungskonsole rotieren, ohne echte Archiv-Benutzer anzufassen.
• Wenn du SPE über mehrere Management-Hosts verteilst, konfiguriere einen Check pro Management-Host — jeder wird unabhängig abgefragt.
• Die Kennzahl Benutzer gesamt im Check-Ergebnis ist die Summe über alle Instanzen — nützlich für Lizenz-Tracking und Kapazitätsplanung.