Prüfungen aus Agent Client Collector-Community aktivieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Sie können Prüfungen aus der GitHub-Community abrufen und zur Verwendung in Agent Client Collector (ACC) anpassen oder eigene Skripts erstellen. Erstellen Sie ein Plugin mit der benutzerdefinierten Sensu-Prüfung, und installieren Sie es für eine ServiceNow-Instanz.

    Vorbereitungen

    Erforderliche Rolle: agent_client_collector_admin

    Prozedur

    1. Kopieren Sie eine Prüfung aus der GitHub-Community auf Ihren lokalen Computer.
    2. Erstellen Sie eine tar.gz-Datei, die an Ihr Plugin angehängt werden soll:
      1. Erstellen Sie einen Ordner auf Ihrem lokalen Computer.
      2. Erstellen Sie einen Unterordner mit der Bezeichnung bin.
      3. Legen Sie die Prüfungen im Ordner bin ab, die Sie ausführen möchten (Skripts und ausführbare Dateien).
      4. Erteilen Sie in einer Linux-Umgebung den Prüfungen Ausführungsberechtigungen, indem Sie für jede Prüfung chmod + x filename ausführen.
      5. Navigieren Sie zum übergeordneten Ordner (über dem bin-Ordner).
      6. Führen Sie in einer Linux-Umgebung den Befehl tar -C <parent_folder_name> --zcvf <my_plugin_name>.tar.gz * aus.
        Verwenden Sie in einer Windows-Umgebung ein Archivierungsdienstprogramm, das das Format tar.gz unterstützt.
      7. Achten Sie in einer Windows-Umgebung darauf, dass in den Ordner bin die folgenden Skripts eingefügt werden:
        • Batch-Skript, das für die Ausführung des Prüfbefehls und zur Initiierung der Ausführung konfiguriert ist. Beispiel:powershell <%~dp0>\test.ps1.

          Die Variable <%~dp0> verweist auf das Laufwerk (d) und den Pfad (p) der Batch-Datei.

        • Das relevante Skript (z. B. test.ps1), das im Batch-Skript ausgeführt werden soll
    3. Erstellen Sie ein neues ACC-Plugin (siehe Plugins erstellen und bearbeiten).
    4. Testen Sie das neue Plugin.
      1. Erstellen Sie eine neue Prüfungsdefinition für die angepasste Sensu-Prüfung.
        Details finden Sie unter Prüfungen erstellen und bearbeiten.
      2. Navigieren Sie auf der Seite Check Definition (Prüfungsdefinition) zum Abschnitt Related Links (Zugehörige Links), und klicken Sie auf Generate allow list content (Inhalte für Allow-Liste generieren).
      3. Kopieren Sie die Einträge, die Sie in die Allow-Liste aufnehmen möchten, und fügen Sie sie der Datei check-allow-list.json des Agent entweder manuell oder mit einem Automatisierungs-Tool hinzu.
        Der Speicherort dieser Datei ist im Parameter allow-list der Datei acc.yml des Agent angegeben.
      4. Erstellen Sie eine neue Richtlinie, und fügen Sie die neu erstellte Prüfungsdefinition hinzu.
        Details zum Erstellen einer Richtlinie finden Sie unter Neue Agent Client Collector-Richtlinie erstellen.
      5. Wählen Sie die Prüfungsdefinition aus, und klicken Sie im Abschnitt Related Links (Zugehörige Links) auf Test check (Testüberprüfung).
    5. Aktivieren Sie Anmeldeinformationen beim Testen einer Prüfung:
      1. Navigieren zu Verbindungen und Anmeldeinformationen > Berechtigungen.
      2. Klicken Sie auf Neu.
      3. Wählen Sie den Typ der Anmeldeinformationen aus, die Sie erstellen möchten.
        Weitere Informationen zum Erstellen von Anmeldeinformationen finden Sie unter Aliasse für Verbindungen und Anmeldeinformationen erstellen.
      4. Geben Sie auf der Seite Werte in die Felder ein, denen Anmeldeinformationen zugewiesen werden sollen <Tabelle mit Liste der Anmeldeinformationsarten und ihrer entsprechenden Fehler eingeben>.
      5. Klicken Sie auf Absenden.
    6. Erstellen Sie für Ihre Prüfung sichere Parameter (siehe Sichere Parameter für Prüfungen erstellen).