Service Graph-Connector für OpenTelemetry konfigurieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 7 Minuten Lesedauer
  • Richten Sie geplante Importaufträge ein, um Daten aus ServiceNow Cloud Observability (früher Lightstep) in Ihren Configuration Management Database (CMDB)abzurufen .

    Vorbereitungen

    Zur Verwendung von Service Graph Connectorbenötigen Sie ein Abonnement für eine Abonnementeinheit, die auf der Anwendung IT Operations Management (ITOM) Visibility oder der Anwendung ITOM Discovery basiert. Wie im Abschnitt „Verwaltete IT-Ressourcentypen“ in der Übersicht über ServiceNow-Abonnementeinheiten für Ihr Abonnement definiert, gilt für verwaltete IT-Ressourcen, die in CMDB von diesem Service Graph Connectorerstellt oder geändert, aber noch nicht von ITOM Visibility oderverwaltet werden ITOM Discovery erhöhen diese Ressourcen den Verbrauch von Abonnementeinheiten für diese Anwendung. Überprüfen Sie Ihren aktuellen Abonnementverbrauch in ITOM Visibility oder ITOM Discovery, um die verfügbare Kapazität sicherzustellen.

    Abhängigkeiten und Anforderungen:
    • Die Store-App Integration Commons for CMDB, die automatisch installiert wird.
    • Die Store-App CMDB CI Class Models, die automatisch installiert wird. Weitere Informationen finden Sie unter Store-App „CMDB CI Class Models“.
    • Das Plugin „ITOM Discovery License“ (com.snc.itom.discovery.license). Sie müssen dieses Plugin aktivieren.
    • Plugin „ITOM Licensing“ (com.snc.itom.license). Weitere Informationen finden Sie unter Discovery anfordern.
    • Das Plugin „Datastream Action“ (com.glide.hub.action_type.datastream), das automatisch installiert wird.
    • Observability Commons für CMDB (sn_observability), das nur für die Event-Erfassung erforderlich ist. Damit Event Management funktioniert, muss die App Observability Commons for CMDB vor der Installation des Connectors installiert werden. Weitere Informationen finden Sie unter Observability Commons für CMDB im ServiceNow Store.
    Hinweis:
    Wenn Sie eine frühere Version von Service Graph-Connector für OpenTelemetryhaben, migrieren Sie keine Daten aus dem alten Connector. Sie müssen die vorherige Version deinstallieren und die neue Integration ausführen.

    Erforderliche Rolle: admin

    Prozedur

    1. Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf Service Graph-Connector für OpenTelemetry festgelegt ist.
      Weitere Informationen finden Sie unter Anwendungsauswahl.
    2. Navigieren zu Alle > Service Graph Connectors > OpenTelemetry > Setup.
    3. Wählen Sie auf der Seite „Erste Schritte“ die Option Erste Schritteaus.
    4. Konfigurieren Sie die Anwendungseigenschaften, um Ihre Organisations- und Authentifizierungsanmeldeinformationen zum Senden von Anforderungen an die ServiceNow Cloud Observability -APIs einzurichten.
      1. Wählen Sie im Abschnitt „ Verbindung konfigurieren“ der Seite „ Service Graph Connector für OpenTelemetry“ Erste Schritte aus.
      2. Stellen Sie für die Aufgabe OpenTelemetry verwenden sicher, dass die Anwendung Cloud Observability die Bedingungen erfüllt, die im Artikel ServiceNow Cloud Observability-Setup [KB1527588] in der Knowledge Base von Now Support erläutert werden.
        Wichtig:
        Notieren Sie sich Ihre Projekte, Ihre Organisation und die API-Schlüsseldetails der Anwendung Cloud Observability, die später bei der Installation des Connectors verwendet werden sollen.
        Nachdem Sie die OpenTelemetry -Umgebung in der Anwendung Cloud Observability eingerichtet haben, kehren Sie zum geführten Setup zurück, und markieren Sie die Aufgabe OpenTelemetry verwenden, um sie abzuschließen, indem Sie Als abgeschlossenmarkieren auswählen.
      3. Geben Sie Ihre Cloud Observability Organisationsdetails ein, aus der Sie die Projekte, Ressourcen und Informationen zur Abhängigkeitszuordnung abrufen möchten.
        1. Wählen Sie für die Aufgabe „Organisation einrichten“ die Option Konfigurierenaus.
        2. Geben Sie im Feld Wert des Formulars „Service Graph-Verbindungseigenschaften“ den Namen Ihrer Cloud Observability -Organisation ein.
        3. Wählen Sie Aktualisieren.
        4. Markieren Sie die Aufgabe Richten Sie Ihre Organisation ein, um sie abzuschließen, indem Sie Als abgeschlossenmarkieren auswählen.
      4. Geben Sie die API-Schlüsseldetails ein, die der Anwendung Cloud Observability zugeordnet sind.
        1. Wählen Sie für die Aufgabe API-Schlüssel einrichten Konfigurierenaus.
        2. Geben Sie im Feld API-Schlüssel des Formulars „API-Schlüssel-Anmeldeinformationen“ den API-Schlüssel ein, der der Anwendung Cloud Observability zugeordnet ist und den Sie sich in Schritt 4.bnotiert haben.
        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe „API-Schlüssel einrichten“ auf „Abgeschlossen“ fest, indem Sie Als abgeschlossenmarkieren auswählen.
      5. Testen Sie die API-Verbindung Cloud Observability, um Daten aus der Anwendung Cloud Observability ] zu importieren.
        1. Wählen Sie für die Aufgabe Verbindung testen die Option Konfigurierenaus.
        2. Wählen Sie den zugehörigen Link Testverbindung aus.
        3. Wenn das Feld Status auf Erfolgfestgelegt ist, wählen Sie X, um das Dialogfeld Verbindung testen zu schließen und zur Seite des geführten Setups zurückzukehren.

          Wenn einer der Tests Fehler aufweist, befolgen Sie die Vorschläge zur Korrektur.

        4. Legen Sie die Aufgabe Verbindung testen auf Abgeschlossen fest, indem Sie Als abgeschlossenmarkieren auswählen.
      6. Rufen Sie alle Projekte ab, die in Ihrer Cloud Observability -Organisation enthalten sind.
        1. Wählen Sie für die Aufgabe „Projekte abrufen“ die Option Konfigurierenaus.
        2. Wählen Sie Projekte abrufen aus.
        3. Wenn die zugehörige Liste „Projekteigenschaften“ mit allen Projekten gefüllt ist, die in der in Schritt 4.c.iiangegebenen Organisation enthalten sind, wählen Sie X, um das Dialogfeld „ Projekte abrufen“ zu schließen und zur Seite des geführten Setups zurückzukehren.
        4. Legen Sie die Aufgabe Projekte abrufen auf Abgeschlossen fest, indem Sie Als abgeschlossenmarkieren auswählen.
    5. Wahlweise: Konfigurieren Sie zusätzliche Konfigurationen, um die Rückblickzeit einzurichten, ausgeschlossene Projekte hinzuzufügen, Projektdiagnosen auszuführen und Integrationseinstellungen für Servicezuordnungen und veraltete Konfigurationselemente (CIs) zu konfigurieren.
      1. Wählen Sie im Abschnitt „ Erweiterte Einstellungen “ der Seite „ Service Graph Connector für OpenTelemetryContinueaus.
      2. Richten Sie die Rückblickzeit ein, ab der Sie Ressourcen aus den Projekten abrufen möchten.

        Die Rückblickzeit wird verwendet, um die Start- und Endzeit für das Abrufen von Ressourcen aus einem Projekt einer Organisation zu berechnen, und sollte mit der Häufigkeitseinstellung der geplanten Aufgabe übereinstimmen. Wenn die Rückblickzeit beispielsweise auf 12 Stunden festgelegt ist, werden Ressourcen ab der Startzeit abgerufen, die als aktuelle Zeit minus 12 Stunden berechnet wird, und bis zur Endzeit, die der aktuellen Zeit entspricht.

        1. Wählen Sie für die Aufgabe „Rückblickzeit einrichten“ die OptionKonfigurierenaus.
        2. Geben Sie im Feld Wert des Formulars „Service Graph-Verbindungseigenschaften“ die Rückblickzeit in Stunden ein.
        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe „Rückblickzeit einrichten“ auf „Abgeschlossen“ fest, indem Sie Als abgeschlossenmarkieren auswählen.
      3. Wählen Sie die Projekte aus, aus denen Sie keine Ressourcen abrufen möchten.
        1. Wählen Sie für die Aufgabe Ausgeschlossene Projekte hinzufügen die Option Konfigurierenaus.
        2. Wählen Sie in der Spalte Projekt ein Projekt aus.
        3. Aktivieren Sie das Kontrollkästchen Projekt ausschließen.
        4. Wählen Sie Aktualisieren.
        5. Wiederholen Sie die Schritte 5.c.ii bis 5.c.iv für jedes Projekt, das Sie ausschließen möchten.
        6. Wählen Sie X aus, um das Dialogfeld Ausgeschlossene Projekte hinzufügen zu schließen und zur Seite des geführten Setups zurückzukehren.
        7. Legen Sie die Aufgabe Ausgeschlossene Projekte hinzufügen auf Abgeschlossen fest, indem Sie Als abgeschlossenmarkieren auswählen.
      4. Führen Sie eine Projektdiagnose aus, um die Antwort der Ressourcen-API zu testen und sicherzustellen, dass die API den Clusternamen KubernetesKubernetes, den Namespace Kubernetes und die Knoten [] enthält.
        1. Wählen Sie für die Aufgabe „Projektdiagnose ausführen“ die Option Konfigurierenaus.
        2. Wählen Sie in der Spalte Projekt ein Projekt aus.
        3. Wählen Sie Diagnose ausführen aus.
        4. Wenn das Feld Diagnosestatus auf Erfolggesetzt ist, wählen Sie X, um das Dialogfeld „ Projektdiagnose ausführen “ zu schließen und zur Seite des geführten Setups zurückzukehren.

          Wenn einer der Diagnosetests Fehler aufweist, befolgen Sie die Anweisungen im Feld Diagnosenachricht, um die Fehler zu beheben.

        5. Wiederholen Sie die Schritte 5.d.ii bis 5.d.iv für jedes Projekt, für das Sie eine Diagnose ausführen möchten.
        6. Legen Sie die Projektdiagnoseaufgabe „Projektdiagnose ausführen“ auf „Abgeschlossen“ fest, indem Sie Als abgeschlossenmarkieren auswählen.
      5. Konfigurieren Sie die Systemeigenschaften für Servicezuordnungen und veraltete CIs.
        1. Wählen Sie für die Aufgabe „Systemeigenschaften für Connectorkonfigurieren“ die Option Konfigurierenaus.
        2. Überprüfen Sie die Standardwerte für die Eigenschaften, oder geben Sie die Werte für eine benutzerdefinierte Konfiguration ein.
        3. Wählen Sie Speichern.
        4. Legen Sie die Aufgabe Konfigurieren der Systemeigenschaften für den Connector auf Abgeschlossen fest, indem Sie Als abgeschlossenmarkieren auswählen.
    6. Konfigurieren Sie die regelmäßigen Aufgaben, um Daten aus der Anwendung Cloud Observability zu importieren.
      1. Wählen Sie im Abschnitt „Geplante Importaufträge konfigurieren“ der Seite „ Service Graph Connector für OpenTelemetryContinueaus.
      2. Wählen Sie für die Aufgabe „Geplante Aufgabe konfigurieren“ Konfigurierenaus.
      3. Wählen Sie die geplante Aufgabe aus, die Sie aktivieren möchten.
      4. Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte für die geplante Aufgabe.
        Weitere Informationen finden Sie unter Schedule a data import.
      5. Wählen Sie Jetzt ausführen.
      6. Wiederholen Sie die Schritte 6.c bis 6.e für jede geplante Aufgabe für den Datenimport.
      7. Wählen Sie das Zurück-Symbol (<), um zur Seite des geführten Setups zurückzukehren.
      8. Legen Sie die Aufgabe „Geplante Aufgabe konfigurieren“ auf „Abgeschlossen“ fest, indem Sie im Guided Setup die Option Als abgeschlossen markieren auswählen.
    7. Verwalten Sie Warnungen und Events, indem Sie Events aus der Anwendung Cloud Observability an die Anwendung ServiceNow Ereignismanagement senden.
      Sie können Warnungen und Events nur verwalten, wenn die Anwendung Observability Commons for CMDB installiert ist.
      Hinweis:
      Zum Aktivieren dieser Funktion ist eine kostenpflichtige Cloud Observability -Lizenz erforderlich. Die Funktion ist jedoch auch für kostenlose -Konten verfügbar, um das Produkt in Nicht-Produktionsumgebungen zu evaluieren. Wenden Sie sich an Ihren ServiceNow -Kundenbetreuer, um weitere Informationen zu erhalten.
      1. Wählen Sie im Abschnitt „ Warnungen und Events verwalten “ der Seite „ Service Graph Connector für OpenTelemetry “ die Option Fortsetzenaus.
      2. Erstellen Sie ein Webhook-Ziel für ein Projekt.
        1. Wählen Sie für die Aufgabe Webhook erstellen die Option Konfigurierenaus.
        2. Wählen Sie ein Projekt aus, das nicht aus der Spalte Projekt ausgeschlossen ist.
        3. Wählen Sie Webhook erstellen aus, um ein Webhook-Ziel in der Anwendung Cloud Observability zu erstellen.
        4. Wenn eine Erfolgsmeldung angezeigt wird, wählen Sie X, um das Dialogfeld Webhook erstellen zu schließen und zur Seite des geführten Setups zurückzukehren.

          Wenn der Webhook erfolgreich erstellt wurde:

          • Das System erstellt automatisch einen Benutzerdatensatz für jedes Webhook-Ziel in Ihrer ServiceNow -Instanz.
          • Der Benutzername des Benutzerdatensatzes beginnt mit ls_api_<project_name> und dem Benutzer wird die Rolle evt_mgmt_integration zugewiesen.
        5. Wiederholen Sie die Schritte 7.b.ii bis 7.b.iv für jedes Projekt, für das Sie einen Webhook erstellen möchten.
        6. Legen Sie die Webhook-Aufgabe „Create a webhook“ (Webhook erstellen) auf „ Abgeschlossen “ fest, indem Sie im Guided Setup die Option Als abgeschlossen markieren auswählen.
      3. Konfigurieren Sie die Systemeigenschaft für die Erfassung von Events, für die keine übereinstimmenden CIs in der CMDB vorhanden sind.
        1. Wählen Sie für die Aufgabe Konfigurieren Sie die Eigenschaft für nicht abgeglichene CIsKonfigurierenaus.
        2. Im Feld Wert geben Sie wahr ein.
        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe „Eigenschaft für nicht abgeglichene CIs konfigurieren“ auf „Abgeschlossen“ fest, indem Sie im geführten Setup die Option Als abgeschlossen markieren auswählen.