Seminar Centreon API, CLAPI und Automatisierung

Seminarprofil

Der zweitägige Workshop vermittelt eine sichere Automatisierung von Konfigurations- und Betriebsaufgaben. CLAPI, REST API, API-Tokens und Import-/Exportmechanismen werden nach Einsatzzweck abgegrenzt und in wiederholbare Abläufe überführt.

Besonderes Gewicht liegt auf idempotentem Vorgehen, Fehlerbehandlung, Berechtigungen und nachvollziehbarer Protokollierung. Beispiele reichen vom Massenimport über Statusabfragen bis zur Integration in Bereitstellungs- und ITSM-Prozesse.

Inhaltsübersicht

1. Schnittstellen auswählen und absichern
2. CLAPI für Konfigurationsobjekte
3. REST API und Echtzeitdaten
4. Reproduzierbare Automatisierung
5. Integration und Ereignisweitergabe
6. Tests, Betrieb und Fehleranalyse

Seminarinhalte

1. Schnittstellen auswählen und absichern

1. Schritt 1: Automatisierungsfälle erfassen und entscheiden, ob CLAPI, REST API v1, REST API v2, MAP API oder AWIE fachlich geeignet ist.
2. Schritt 2: Dienstkonten, Rollen, API-Tokens, Ablaufzeiten und minimale Berechtigungen nach dem Least-Privilege-Prinzip planen.
3. Schritt 3: Testumgebung, Versionsbezug, Namenskonventionen und Protokollierung als verbindliche Rahmenbedingungen festlegen.

2. CLAPI für Konfigurationsobjekte

1. Schritt 1: Objekte und Aktionen auflisten, Syntax prüfen und einzelne Hosts, Services, Gruppen, Templates sowie Makros verwalten.
2. Schritt 2: Importdateien für Massenänderungen erstellen, Vorabprüfungen durchführen und fehlerhafte Datensätze isolieren.
3. Schritt 3: Konfiguration generieren, testen, verteilen und Neustartmethoden kontrolliert über die Kommandozeile auslösen.

3. REST API und Echtzeitdaten

1. Schritt 1: Authentifizierung durchführen, Versionspfad und Endpunkte bestimmen sowie Requests mit Headern, Parametern und JSON-Daten aufbauen.
2. Schritt 2: Ressourcen, Ereignisse und Konfigurationsdaten filtern, paginieren und in weiterverarbeitbare Strukturen überführen.
3. Schritt 3: HTTP-Statuscodes, Validierungsfehler, Zeitüberschreitungen und unvollständige Antworten systematisch behandeln.

4. Reproduzierbare Automatisierung

1. Schritt 1: Sollzustände beschreiben und vor einer Änderung den vorhandenen Zustand abfragen, um unnötige Schreibvorgänge zu vermeiden.
2. Schritt 2: Skripte in kleine, prüfbare Funktionen gliedern und Geheimnisse außerhalb von Quelltext und Protokolldateien verwalten.
3. Schritt 3: Dry-Run, Wiederholbarkeit, Sperrkonzept, Transaktionsgrenzen und Rücknahmeverfahren für produktive Läufe definieren.

5. Integration und Ereignisweitergabe

1. Schritt 1: Monitoring-Daten für CMDB-, Deployment-, Ticketing- oder Reporting-Prozesse mit eindeutigen Schlüsseln bereitstellen.
2. Schritt 2: Stream Connectors und Open-Ticket-Funktionen gegenüber eigener API-Logik abgrenzen und passende Filterregeln planen.
3. Schritt 3: Ein End-to-End-Szenario vom Quellsystem über die Centreon-Konfiguration bis zur Rückmeldung an das Zielsystem testen.

6. Tests, Betrieb und Fehleranalyse

1. Schritt 1: Positiv-, Negativ-, Last- und Berechtigungstests mit wiederholbaren Testdaten ausführen.
2. Schritt 2: API- und CLAPI-Ausgaben, Webserver-Logs, Centreon-Logs sowie Änderungsprotokolle zu einer Diagnosekette zusammenführen.
3. Schritt 3: Versionierung, Freigabe, Monitoring der Automatisierung und Verantwortlichkeiten für Wartung und Störungsbehebung dokumentieren.

Praxisübungen

• Massenanlage von Hosts und Services über CLAPI mit anschließender Konfigurationsprüfung
• Abfrage gefilterter Ressourcen über REST API v2 und Auswertung der JSON-Antwort
• Entwicklung eines idempotenten Änderungsablaufs mit Dry-Run und Fehlerprotokoll
• Entwurf einer sicheren Integration zwischen Bereitstellungsprozess und Monitoring

Zielgruppe

Centreon-Administratoren, DevOps- und Plattformteams, Automatisierungsentwickler sowie technische Integratoren

Voraussetzungen

Gute Centreon-Konfigurationskenntnisse, sichere Kommandozeilenpraxis und Grundlagen in HTTP, JSON sowie einer Skriptsprache