Integration von DX Operational Intelligence

Als Systemadministrator installieren und konfigurieren Sie alle Komponenten, die für die Integration von DX Operational Intelligence und Ihres Automic Automation-Systems relevant sind. Diese Integration ist nur für Automic Automation-Systeme mit PostgreSQL- oder Oracle-Datenbanken verfügbar.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

Zuerst müssen Sie DX Platforminstallieren. Weitere Informationen finden Sie in der offiziellen DX Platform Dokumentation unter DX Platform vor Ort.

Wichtig! Stellen Sie beim Einrichten von DX Operational Intelligence sicher, dass Ihre TENANT_ID nur Großbuchstaben verwendet, da dies später im Automic Automation-System erforderlich ist. Wenn die TENANT_ID in DX Operational Intelligence und Automic Automation nicht übereinstimmt, schlagen Single Sign-Ons fehl.

Als Nächstes müssen Sie Automic Automation installieren. Sie können es von unserem Downloadcenter unter https://downloads.automic.com/herunterladen. Weitere Informationen finden Sie unter Installation Automic Automation.

Wichtig!

  • Verwenden Sie für diese Integration ein dediziertes Automic Automation-System, nicht das System, das Sie einsetzen.

  • Für die Integration mit DX Operational Intelligence SaaS muss die REST-API Port 443 verwenden. Stellen Sie sicher, dass Sie die Standard-Portkonfiguration für den REST-Prozess in der INI-Datei der Automation Engine auf 443 ändern, siehe Automation Engine – INI-Datei.

Außerdem können Sie die Anmeldung von der Automic Automation-Anmeldemaske auf die DX Operational Intelligence-Anmeldeseite umleiten und umgekehrt, indem Sie Umgebungsvariablen in Ihrem Betriebssystem erstellen:

  • UC_AIOPS_LOGIN_ENABLED: Diese Umgebungsvariable aktiviert die Anmeldung von DX Operational Intelligence bei Automic Automation. Sie ermöglicht Ihnen auch, den AIOPS-Anmeldetyp in der Automic Automation-Anmeldemaske anzuzeigen, der für die Umleitung der Anmeldung von Automic Automation zu DX Operational Intelligence erforderlich ist.

    Wert: Setzen Sie die Umgebungsvariable auf Y oder TRUE (keine Berücksichtigung der Groß-/Kleinschreibung), um den Anmeldetyp in Automic Automation zu aktivieren.

  • UC_AIOPS_LOGIN_URL: Diese Umgebungsvariable speichert den relevanten Pfad (URL) für die Umleitung von der Automic Automation-Anmeldemaske auf die DX Operational Intelligence-Anmeldeseite.

    Wert: Pfad (URL) zur DX Operational Intelligence-Anmeldeseite

    Beispiele

    URL für lokales DX Operational Intelligence:

    http(s)://adminui.<hostname or IP>.nip.io/sppclient/#/login

    URL für DX Operational Intelligence als SaaS:

    https://axa.dxi-na1.saas.broadcom.com/sppclient/#/login

Hinweis: Sie müssen die Automic Web Interface neu starten, wenn eine Umgebungsvariable festgelegt oder geändert wird. Weitere Informationen finden Sie unter Login.

Automic Automation für die Integration konfigurieren

Für die Integration sind mehrere Dateien relevant:

  • UC_AIOPS_SETTINGS.xml
  • USRG_PU.xml
  • USRG_TA.xml
  • USRG_UZ.xml
  • WELCOME.DASHBOARD.AIOPS.xml

Diese Dateien enthalten die Variable UC_AIOPS_SETTINGS, mit der Sie die Integration konfigurieren können, sowie die Definition der Benutzergruppe, die für die spätere Zuordnung von Benutzern erforderlich ist. Das Angebot umfasst auch die Datei AIOps_SampleWorkflows.xml, die verschiedene vorkonfigurierte Workflows enthält, mit denen sich einige der häufigsten Probleme lösen lassen.

Diese Dateien befinden sich im Ordner AiOps.Extensions, der zusammen mit dem Angebot bereitgestellt wird. Sie können sie aus der Automic Web Interfaceimportieren.

Mehr Informationen:

Hinweis: Sie benötigen einen dedizierten Mandanten und einen Benutzer für die Integration. Diese Zugangsdaten werden verwendet, wenn Sie DX Operational Intelligence für die Integration konfigurieren. In diesem Abschnitt werden Mandant 100 und der Benutzer AUTOMIC als Beispiele verwendet.

Automic Automation für die Integration konfigurieren

  1. Öffnen Sie in Mandant 0 die Process Assembly-Perspektive, wählen Sie den Ordner aus, den Sie verwenden möchten, und importieren Sie die unten aufgeführten Dateien. Weitere Informationen finden Sie unter Objekte importieren/exportieren.

    • UC_AIOPS_SETTINGS.xml
    • USRG_PU.xml
    • USRG_TA.xml
    • USRG_UZ.xml

    Die Datei WELCOME.DASHBOARD.AIOPS.xml kann nicht in Mandant 0 importiert werden. Sie müssen sie später in den Mandanten importieren, den Sie für die Integration verwenden.

  2. Öffnen Sie die Variable UC_AIOPS_SETTINGS und geben Sie die TENANT_ID des für die Integration verwendeten DX Operational Intelligence-Mandanten ein, siehe UC_AIOPS_SETTINGS - DX Operational Intelligence integrieren.

    Wichtig! Achten Sie darauf, dass die TENANT_ID ausschließlich in Großbuchstaben geschrieben wird.

  3. Erstellen Sie Mandant 100, siehe Mandanten.

    Die importierte Variable und Benutzergruppen sind nur in Mandant 0 sichtbar, werden aber in Mandant 100 verwendet. Das System prüft zuerst, ob sie im aktuellen Mandanten verfügbar sind. Wenn nicht, prüft das System Mandant 0 und verwendet diese Definition.

  4. Einen Benutzer für die Integration in Mandant 100 erstellen, siehe Benutzer (USER).

  5. Loggen Sie sich mit dem eben erstellten Benutzer bei Mandant 100 ein.

  6. Öffnen Sie die Process Assembly-Perspektive, und importieren Sie die Datei WELCOME.DASHBOARD.AIOPS.xml, siehe Objekte importieren/exportieren.

  7. Importieren Sie die xml-Datei mit den Beispiel-Workflows für die Fehlerbehebung, während Sie sich immer noch in der Process Assembly-Perspektive befinden.

    Stellen Sie sicher, dass der Ordner, den Sie zum Importieren der Beispiel-Workflows verwenden, derjenige ist, den Sie im Parameter location definiert haben, als Sie DX Operational Intelligence für die Integration konfiguriert haben, siehe DX Operational Intelligence für die Integration konfigurieren. Wenn Sie beispielsweise "location": "/AIOPS" definieren, verwenden Sie den Ordner AIOPS im Explorer (Process Assembly).

  8. Setzen Sie in Mandant 0 den Parameter GENERATE_UNDEFINED_SCRIPT_VARS in den UC_SYSTEM_SETTINGS auf YES, siehe GENERATE_UNDEFINED_SCRIPT_VARS.

    Dies ermöglicht dem System, die Beispiel-Workflows für die Fehlerbehebung zu verarbeiten. Wenn der Parameter nicht auf YES gesetzt ist, schlagen die Beispiel-Workflows fehl und es wird eine Fehlermeldung ausgegeben.

  9. Öffnen Sie die Variable UC_AIOPS_SETTINGS und überprüfen Sie, ob alle Parameter richtig definiert sind:

    • CLIENT: 100

    • ESS_REST_URL: DX Operational Intelligence Sicherheitsendpunkt

      Beispiele

      Sicherheitsendpunkt für lokales DX Operational Intelligence:

      http://adminui.<hostname>.nip.io/ess/security/v1/me

      Sicherheitsendpunkt für DX Operational Intelligence als SaaS:

      https://axa.dxi-na1.saas.broadcom.com/ess/security/v1/me

    • ROLE_PU: USRG_PU

    • ROLE_TA: USRG_TA

    • ROLE_UZ: USRG_UZ

    • TENANT_ID: ID des Mandanten, der für die Integration verwendet wird

      Wichtig! Achten Sie darauf, dass die TENANT_ID-Definition in DX Operational Intelligence nur Großbuchstaben verwenden darf.

    Weitere Informationen finden Sie unter UC_AIOPS_SETTINGS - DX Operational Intelligence integrieren.

DX Operational Intelligence für die Integration konfigurieren

Sie müssen ein Mandantenadministrator sein, um DX Operational Intelligence für die Integration in Automic Automation zu konfigurieren.

DX Operational Intelligence muss in der Lage sein, den REST-Endpunkt von Automic Automation aus aufzurufen. Der REST-Serverprozess muss in Ihrem Automic Automation-System ausgeführt werden. Weitere Informationen finden Sie unter Serverprozesstypen.

Wichtig! Sobald DX Operational Intelligence und Automic Automation über die REST-API kommunizieren können, können Sie diese Verbindung und die Workflows zur Fehlerbehebung verwenden, ohne sich bei Automic Automation anmelden zu müssen. Sie benötigen jedoch einen Automic Automation-Benutzer mit den entsprechenden Rechten, um die Variable UC_AIOPS_SETTINGS und den für die Workflows zur Fehlerbehebung verwendeten Speicherordner in Automic Automation definieren zu können. Andernfalls funktioniert die Integration nicht ordnungsgemäß.

DX Operational Intelligence für die Integration konfigurieren

  1. Zugriff auf Automic Intelligent Remediation, siehe Zugriff auf Automic Intelligent Remediation..

  2. Öffnen Sie die Seite Einstellungen, und wählen Sie Automatisierung im Abschnitt Externe Verbindungen/Integrationen aus.

  3. Stellen Sie sicher, dass die Integration aktiviert ist, und definieren Sie die folgenden Parameter:

    • Name: AUTOMIC

    • Automatisierungsplattformtyp: AUTOMIC

    • API URL: AE REST API URL

      Verweist auf die URL der Automation Engine REST-API

    • Konsolen-URL: AWI URL

      Verweisen Sie auf die URL der Automic Web Interface

    • Benutzername: AUTOMIC

      Name des Automic Automation/REST API-Benutzers (Zugangsdaten Mandant 100)

    • Kennwort: Geben Sie das Kennwort ein.

      Kennwort des Automic Automation/REST-API-Benutzers (Zugangsdaten Mandant 100)

    • Mandanten-ID: 100

  4. Aktivieren Sie das Kontrollkästchen Bereich einschränken, um den Bereich der Workflows einzuschränken, die als Workflows zur Fehlerbehebung in DX Operational Intelligence angezeigt werden.

  5. Aktivieren Sie die Funktion Erweitert, und geben Sie die relevanten Filterkriterien ein, um anzugeben, welche Nutzlasten angezeigt werden sollen.

    Beispiel

    Die folgenden Filterkriterien zeigen die Beispiel-Workflows für die Fehlerbehebung an, die für die Integration einbezogen wurden:

    {
    "filters": [
        {
            "location": "/AIOPS",
            "include_links": false,
            "include_subfolders": true,
            "filter_identifier": "location"
        },
        {
            "filter_identifier": "object_type",
            "object_types": [
                "JOBP"
            ]
        }
    ],
    "max_results": "1000"
}

    Der Ordner, den Sie im Parameter locationdefinieren, ist der Ordner, den Sie beim Importieren des Beispiel-Workflows für die Fehlerbehebung in Automic Automation verwenden sollten. Wenn Sie beispielsweise "location": „/AIOPS" definieren, verwenden Sie den Ordner AIOPS im Explorer (Process Assembly).

  6. Testen Sie Ihre Verbindung. Wenn sie erfolgreich eingerichtet werden kann, klicken Sie auf Speichern.

Weitere Informationen finden Sie in der offiziellen DX Platform Dokumentation unter DX Platform vor Ort.

Siehe auch: