--- sourceDocument: Yokohama IT Operations Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/it-operations-management Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Erstellen Sie einen anwenderdefinierten Pull Connector # Erstellen Sie einen anwenderdefinierten Pull Connector {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer Sie können einen anwenderdefinierten Pull Connector erstellen, der ein Skript, eine Connector-Definition und eine Connector-Instanz erfordert, um Ereignisse im Namen einer Ereignisquelle abzurufen. ## Vorbereitungen Erforderliche Rolle: evt_mgmt_admin ## Warum und wann dieser Vorgang ausgeführt wird Ein anwenderdefiniertes Connector-Skript kann Remote-API-Aufrufe für eine neue Ereignisquelle durchführen, um Ereignisse an zu senden ServiceNowInstanz. Sie können ein Skript erstellen und es dann als Teil eines neuen hinzufügen EreignismanagementConnector-Definition und Connector-Instanz. Dieses Verfahren erstellt automatisch eine JavaScript-Codedatei mit dem Namen, den Sie in eingeben Name Feld als Dateiname. Der anwenderdefinierte JavaScript-Code, der diese Aktionen durchführt, muss: * Stellen Sie eine Verbindung zu einem Ereignisüberwachungstool her. * Ruft Ereignisse aus einem Ereignisüberwachungstool ab. * Senden Sie Ereignisse mithilfe einer Webservice-API an die Tabelle „Ereignis" \[em_event\]. Siehe REST-API . {#t_EMCreateCustomConnectorDefinition__ul_mzp_pxm_h5b} Jede Connector-Definition ist spezifisch für einen Ereignisquelllieferanten. Die Connector-Definition gibt die Skripteinbindung des MID-Servers an, die Ereignisse aus der externen Ereignisquelle abruft. Darüber hinaus gibt die Connector-Definition an, welche Connector-Instanzwertparameter für die Verbindung mit dem externen Ereignisquellhost erforderlich sind. ## Prozedur 1. Erstellen Sie eine anwenderdefinierte MID-Server-Skripteinbindung. Dieses Beispiel verwendet Groovy (veraltet). Anstelle einer Skripteinbindung in Groovy wird die Verwendung von JavaScript empfohlen. 1. Implementieren Sie diese Methoden: * @Betriebsstatus testConnection() überschreiben * @Betriebsstatus überschreiben ausführen() {#t_EMCreateCustomConnectorDefinition__ul_pzp_pxm_h5b} 2. Entwerfen Sie die Klasse, um zu erweitern DrittPartyConnector . public class HypericConnector extends ThirdPartyConnector 3. Importieren Sie Plattformklassen für Ereigniserstellung, -Senden, -Protokollierung und Basisklassen von Drittanbieter-Connectors. package com.service_now.mid.probe.tpcon.test import com.glide.util.Log import com.service_now.mid.MIDServer import com.service_now.mid.probe.event.IEventSender import com.service_now.mid.probe.event.SNEventSender import com.service_now.mid.probe.tpcon.OperationStatus import com.service_now.mid.probe.tpcon.OperationStatusType import com.service_now.mid.probe.tpcon.ThirdPartyConnector import com.snc.commons.eventmgmt.Event 4. Stellen Sie über die vom Sammler bereitgestellte API eine Verbindung zum Datenerfasser her, z. B. SCOM oder VMware vRealize Hyperic (Hyperic). 5. Verwenden Sie contextParameter zum Festlegen der Ereignisfeldwerte, die aus einer Connector-Instanz stammen. def authString = (context.username + ':'+ context.password).getBytes().encodeBase64().toString() def urlStr = 'http://'+context.host + ':' + context.parameters.port + '/' + apiFunction 6. Implementieren Sie Ausführen Funktion im Skript. Er liest Ereignisse aus dem Connector mithilfe seiner API, um Ereignisobjekte zu erstellen und an zu senden ServiceNowInstanz. Zum Beispiel: GPathResult alertsResponse1 = readAlerts('hqu/hqapi1/alert/find.hqu?begin=' + lastSignatureStr + '&end='+ tillStr +'&count=1000000&severity=1&inEscalation=false¬Fixed=false'); Event event = new Event() event.emsSystem = context.name event.source = "Hyperic" event.description = it.@reason event.type = it.@name ... IEventSender eventSender = MIDServer.getSingleton(SNEventSender.class) for (Event event : list) { eventSender.sendEvent(event) } {#t_EMCreateCustomConnectorDefinition__substeps_ozp_pxm_h5b} 2. Navigieren zu MID-ServerMID-Serverskriptdateien Und erstellen Sie ein Skript. 3. Geben Sie an Übergeordnet Feld als GroovyFüllen Sie das Formular nach Bedarf aus, und klicken Sie dann auf Übermitteln . 4. Navigieren zu EreignismanagementIntegrationenAnschlussdefinitionen Und erstellen Sie eine Connector-Definition. 5. In Auszuführendes Groovy-Skript Wählen Sie die MID-Server-Skriptdatei aus, und füllen Sie das Formular nach Bedarf aus. Zusätzlich zu Anwendername Oder Host , Sie können jeden anderen Parameter hinzufügen, z. B. Port , Und klicken Sie dann auf Übermitteln . 6. Navigieren zu EreignismanagementIntegrationenAnschlussinstanzen Und erstellen Sie eine Connector-Instanz. 7. In Connector-Definition Wählen Sie die Connector-Definition aus, füllen Sie das Formular nach Bedarf aus, und klicken Sie dann auf Übermitteln . 8. Um das Skript zu bestätigen oder zu debuggen, verwenden Sie Debug-Ausdrucke aus Groovy in das MID-Serverprotokoll. 9. Um eingehende Ereignisse mit der anwenderdefinierten Connector-Instanz zu überwachen, navigieren Sie zu ECCWarteschlange Und filtern nach ConnectorProbe . 10. Erstellen Sie eine anwenderdefinierte Connector-Definition. 1. Navigieren zu AlleEreignismanagementIntegrationenAnschlussdefinitionenan. 2. Klicken Sie auf Neu. 3. In Name Feld: Geben Sie einen beschreibenden Namen für die Connector-Definition ein. 4. In Skripttyp Feld auswählen Javascript . 5. Rechtsklicken Sie auf die Formularüberschrift und wählen Sie Speichern. {#t_EMCreateCustomConnectorDefinition__substeps_gxw_jn1_w5b} Die Auszuführendes JavaScript Feld wird automatisch mit dem Namen der JavaScript-Vorlagendatei ausgefüllt. 11. Klicken Sie zum Bearbeiten der standardmäßigen JavaScript-Datei auf das Informationssymbol ( ![Informationssymbol]()) Rechts neben dem JavaScript-Dateinamen, und führen Sie die folgenden Schritte aus: 1. Geben Sie die Informationen an, die für erforderlich sind Testverbindung Funktion. Diese Funktion testet die Connector-Definition, um zu überprüfen, ob die Verbindung zum Ziel gültig ist. 2. Geben Sie die Informationen an, die für erforderlich sind Ausführen Funktion. Diese Funktion ruft die Informationen aus der externen Quelle ab. 3. Geben Sie die Informationen an, die für erforderlich sind Kpi abrufen Funktion. Diese Funktion ruft die Metrikdaten aus der externen Quelle ab. {#t_EMCreateCustomConnectorDefinition__substeps_kxz_4df_jw} 12. **Wahlweise:** Sie können das Standard-JavaScript durch Ihren JavaScript-Code ersetzen. 13. Füllen Sie die Felder entsprechend aus. {#t_EMCreateCustomConnectorDefinition__table_brj_s41_w5b__entry__2} | Feld | Beschreibung | |:-|:-| | Standardzeitplan | Die Anzahl der Sekunden zwischen den Versuchen, Ereignisse zu empfangen. | | Bidirektional | Geben Sie an, damit das externe Überwachungssystem aktualisiert werden kann, wenn die Warnung geändert wird. Es gibt eine Standardimplementierung für SCOM. | | Identifier für Warnungsfeld | Legen Sie das Warnungsfeld fest, das bei einer manuellen Änderung die Aktualisierung des externen Überwachungssystems auslöst. Hinweis: Dieses Feld wird nur angezeigt, wenn Bidirektional Ist ausgewählt. | | Metriken sammeln | Wählen Sie diese Option, um das Sammeln von Metriken zu aktivieren. Hinweis: Metriken werden nur für externe SCOM-Ereignisquellen erfasst. | | Standardzeitplan für Metriksammlung (Sekunden) | Geben Sie die Anzahl der Sekunden an, die Informationen erfasst werden müssen. Der Standardwert ist 10 Sekunden. Hinweis: Dieses Feld wird nur angezeigt, wenn Erfassen Sie Metriken Ist ausgewählt. | | Connector-Parameter | Geben Sie die Parameter an, um die Kommunikation mit einem Ereignis-Server zu ermöglichen. | | Connector-Definition bis MID-ServerFähigkeiten | Die MID-ServerName zur Verarbeitung von Ereignissen vom Ereignisserver. Wenn nicht angegeben, ist ein verfügbar MID-ServerWird verwendet. | [Tabelle : 1. Connector-Definitionsformular] {#t_EMCreateCustomConnectorDefinition__table_brj_s41_w5b} {#t_EMCreateCustomConnectorDefinition__step_ConnectorDefStep6} {#t_EMCreateCustomConnectorDefinition__step_ConnectorDefStep6} 14. Klicken Sie auf Absenden. {#t_EMCreateCustomConnectorDefinition__step_ConnectorDefStep7} {#t_EMCreateCustomConnectorDefinition__step_ConnectorDefStep7}{#t_EMCreateCustomConnectorDefinition__steps_nzp_pxm_h5b}