Service Graph-Connector für OpenTelemetry konfigurieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 8 Minuten Lesedauer

    • Richten Sie geplante Importaufträge ein, um Daten aus ServiceNow Cloud Observability (früher Lightstep) in 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 ServiceNow-Abonnementeinheitenübersicht für Ihr Abonnement definiert, für verwaltete IT-Ressourcen, die in CMDB von diesem Service Graph Connectorerstellt oder geändert werden, aber noch nicht von ITOM Visibility oderverwaltet werden Bei ITOM Discovery erhöhen diese Ressourcen den Verbrauch von Abonnementeinheiten bei dieser Anwendung. Überprüfen Sie Ihren aktuellen Verbrauch von Abonnementeinheiten in ITOM-Transparenz oder ITOM-Discovery, um die verfügbare Kapazität sicherzustellen.

    Abhängigkeiten und Anforderungen:
    • Die Store App Integration Common for CMDB (Integration Common für CMDB), die automatisch installiert wird.
    • Die Store-App CMDB CI-Klassenmodelle, die automatisch installiert wird. Weitere Informationen finden Sie unter CMDB CI-Klassenmodelle.
    • Plugin „ITOM Discovery License“ (com.snc.itom.discovery.license). Sie müssen dieses Plugin aktivieren.
    • ITOM-Lizenzierungs-Plugin (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 Common für CMDB (sn_observability), das nur für die Ereigniserfassung erforderlich ist. Damit Ereignismanagement funktioniert, muss vor der Installation des Connectors die App Observability Common für CMDB installiert werden. Weitere Informationen finden Sie unter Gemeinsame Observability-Komponenten 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: Administrator

    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 “ 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 OpenTelemetrydie Option Erste Schritteaus.
      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 Now Support beschrieben sind.
        Wichtig:
        Notieren Sie sich Ihre Projekt-, Organisations- und API-Schlüsseldetails der Anwendung Cloud Observability, die später während der Installation des Connectors verwendet werden sollen.
        Nachdem Sie die Umgebung OpenTelemetry in der Anwendung Cloud Observability eingerichtet haben, kehren Sie zum geführten Setup zurück, und markieren Sie die Aufgabe OpenTelemetry verwenden, um abzuschließen, indem Sie Als abgeschlossen markierenwählen.
      3. Geben Sie die Details Ihrer Organisation Cloud Observability ein, von der Sie die Projekte, Ressourcen und Informationen zur Abhängigkeitszuordnung abrufen möchten.
        1. Wählen Sie für die Aufgabe Ihre Organisation einrichtendie Option Konfigurierenaus.
        2. Geben Sie im Feld Wert des Formulars Service Graph-Verbindungseigenschaften den Namen Ihrer Organisation Cloud Observability ein.
        3. Wählen Sie Aktualisieren.
        4. Markieren Sie die Aufgabe Organisation einrichten zum Abschließen, indem Sie Als abgeschlossen markierenwä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 dieOption 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 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 abgeschlossen markierenauswä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 dieOption 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 bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.

        4. Legen Sie die Aufgabe Verbindung testen auf Abgeschlossen fest, indem Sie Als abgeschlossen markierenauswählen.
      6. Rufen Sie alle Projekte ab, die in Ihrer Organisation Cloud Observability enthalten sind.
        1. Wählen Sie für die Aufgabe Projekte abrufen die Option Konfigurierenaus.
        2. Wählen Sie Projekte abrufen.
        3. Wenn die zugehörige Liste Projekteigenschaften mit allen Projekten ausgefü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 abgeschlossen markierenauswä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 Configuration Items (CIs) zu konfigurieren.
      1. Wählen Sie auf der Seite Service Graph Connector für OpenTelemetry im Abschnitt Erweiterte Einstellungendie Option Fortfahren aus.
      2. Richten Sie die Rückblickzeit ein, ab dem 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. Sie sollte der Häufigkeitseinstellung für geplante Aufgaben entsprechen. 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 die aktuelle Zeit ist, abgerufen.

        1. Wählen Sie für die Aufgabe Rückblickzeit einrichtendie Option Konfigurieren aus.
        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 abgeschlossen markierenauswä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ügendie Option Konfigurierenaus.
        2. Wählen Sie ein Projekt in der Spalte Projekt aus.
        3. Aktivieren Sie die Checkbox Projekt ausschließen.
        4. Wählen Sie Aktualisieren.
        5. Wiederholen Sie die Schritte von 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 abgeschlossen markierenauswählen.
      4. Führen Sie eine Projektdiagnose aus, um die Antwort der Ressourcen-API zu testen und sicherzustellen, dass die API den Clusternamen Kubernetes, den Namespace Kubernetes und die Knoten Kubernetes enthält.
        1. Wählen Sie für die Aufgabe Projektdiagnose ausführendie Option Konfigurierenaus.
        2. Wählen Sie ein Projekt in der Spalte Projekt aus.
        3. Wählen Sie Diagnose ausführenaus.
        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 bei einem der Diagnosetests Fehler auftreten, befolgen Sie die Anweisungen im Feld Diagnosemeldung, 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 Aufgabe Projektdiagnose ausführen auf abgeschlossen fest, indem Sie Als abgeschlossen markierenwählen.
      5. Konfigurieren Sie die Systemeigenschaften für Servicezuordnungen und veraltete CIs.
        1. Wählen Sie für die Aufgabe Systemeigenschaften für den Connector konfigurierendie Option Konfigurierenaus.
        2. Überprüfen Sie die Standardwerte für die Eigenschaften, oder geben Sie die Werte für eine anwenderdefinierte Konfiguration ein.
        3. Wählen Sie Speichern.
        4. Stellen Sie die Aufgabe Konfigurieren Sie Systemeigenschaften für den Connector auf Abgeschlossen ein, indem Sie Als Abgeschlossen markierenwählen.
    6. Konfigurieren Sie die geplanten Aufgaben für den Import vollständiger oder inkrementeller Daten aus der Anwendung Cloud Observability.
      1. Wählen Sie auf der Seite Service Graph Connector für OpenTelemetry im Abschnitt Konfiguration für geplante Importaufträgedie Option Fortfahren aus.
      2. Aktivieren Sie die geplante Aufgabe für den vollständigen Datenimport.

        Standardmäßig ist die geplante Aufgabe OpenTelemetry Resources für den vollständigen Datenimport verfügbar. Sie müssen den Auftrag jedoch aktivieren.

        1. Wählen Sie für die Aufgabe Geplante Aufgabe für vollständigen Import konfigurieren die Option Konfigurieren aus.
        2. Überprüfen Sie im Formular „Geplanter Datenimport“ für die geplante Aufgabe OpenTelemetry Resources die Feldwerte für die geplante Aufgabe, und aktivieren Sie das Kontrollkästchen Aktiv.

          Weitere Informationen finden Sie unter Schedule a data import.

        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe Geplante Aufgabe für vollständigen Import konfigurieren auf Abgeschlossen fest, indem Sie im geführten Setup die Option Als abgeschlossen markieren auswählen.
      3. Wahlweise: Aktivieren Sie die geplante Aufgabe für den Delta-Datenimport.

        Standardmäßig ist die geplante Aufgabe OpenTelemetry Delta Resources für den Delta-Datenimport verfügbar. Sie müssen den Auftrag jedoch aktivieren.

        Hinweis:
        Der Delta-Datenabruf erfolgt nicht in den folgenden Szenarien:
        • Für denselben Zeitpunkt ist ein vollständiger Datenimport geplant.
        • Das Feld „Datum/Uhrzeit der letzten Ausführung“ einer Datenquelle ist leer.
        • Der Zeitraum des letzten Delta-Datenabrufs beträgt mehr als 3 Tage.
        1. Wählen Sie für die Aufgabe Geplante Aufgabe für Delta-Import konfigurieren dieOption Konfigurieren aus.
        2. Überprüfen Sie im Formular „Geplanter Datenimport“ für die geplante Aufgabe OpenTelemetry Delta Resources die Feldwerte für die geplante Aufgabe, und aktivieren Sie das Kontrollkästchen Aktiv.

          Weitere Informationen finden Sie unter Schedule a data import.

        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe Geplante Aufgabe für Delta-Import konfigurieren auf den Abschluss fest, indem Sie im geführten Setup die Option Als abgeschlossen markieren auswählen.
      Hinweis:
      Wenn Sie ein neues Projekt zum Abrufen von Ressourcen hinzufügen, führen Sie einen vollständigen Import durch, bevor Sie einen Delta-Import ausführen, um Teildaten zu vermeiden und CMDB genau auszufüllen.
    7. Verwalten Sie Warnungen und Ereignisse, indem Sie Ereignisse von der Anwendung Cloud Observability an die Anwendung ServiceNow Ereignismanagement senden.
      Sie können Warnungen und Ereignisse nur verwalten, wenn die Anwendung Observability Common für 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. Weitere Informationen erhalten Sie von Ihrem Kundenbetreuer für ServiceNow.
      1. Wählen Sie auf der Seite Service Graph Connector für OpenTelemetry im Abschnitt Warnungen und Ereignisse verwaltendie Option Fortsetzen aus.
      2. Erstellen Sie ein Webhook-Ziel für ein Projekt.
        1. Wählen Sie für die Aufgabe Webhook erstellendie Option Konfigurierenaus.
        2. Wählen Sie ein Projekt aus, das nicht in 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 aus, 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 Instanz ServiceNow.
          • Der Anwendername des Anwenderdatensatzes beginnt mit ls_api_<project_name> 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 Aufgabe Webhook erstellen auf „Abgeschlossen“ fest, indem Sie im geführten Setup Als abgeschlossen markieren auswählen.
      3. Konfigurieren Sie die Systemeigenschaft für die Erfassung von Ereignissen, die keine übereinstimmenden CIs in der CMDB haben.
        1. Wählen Sie für die Aufgabe Eigenschaft für nicht abgeglichene CIs konfigurierendie Option Konfigurierenaus.
        2. Im Feld Wert geben Sie wahr ein.
        3. Wählen Sie Aktualisieren.
        4. Legen Sie die Aufgabe Konfigurieren Sie die Eigenschaft für nicht abgeglichene CIs auf Abgeschlossen fest, indem Sie im geführten Setup die Option Als abgeschlossen markieren auswählen.