REST-API-Connectorquellen für New Relic konfigurieren

Verwenden Sie den REST-API-Connector, um Verbindungen zu REST-konformen New Relic-Services herzustellen. Nur die REST-API Users wird unterstützt.

Vorbereitende Schritte

Wichtig: Der REST API-Connector wird nur auf Konnektivität zur genannten REST-API für New Relic überprüft. Der Connector wird mit einem begrenzten Zugriff auf New Relic-Daten geprüft. Das in diesem Thema bereitgestellte Umsetzungsscript gilt nur für die API Users und wurde für andere New Relic-APIs nicht verifiziert. Wenden Sie sich an Ihren Ansprechpartner bei IBM Professional Services, wenn Sie Unterstützung für andere New Relic-APIs benötigen.

Stellen Sie sicher, dass Sie über ein New Relic-Konto verfügen, dass der API-Zugriff aktiviert ist und dass der API-Schlüssel generiert wurde.
Weitere Informationen finden Sie unter Introduction to New Relic REST API.
Stellen Sie sicher, dass der Web-Service, der verbunden werden soll, betriebsbereit ist.
Sie können Daten nur für die REST-APIs Users abrufen.
Weitere Informationen zu URI-Formaten finden Sie unter https://rpm.newrelic.com/api/explore/users.
Verwenden Sie New Relic API Explorer, der in Ihrer New Relic-Instanz verfügbar ist, um API-Anforderungen zu erstellen und zu testen und um URI-Informationen für Datendefinitionen abzurufen.
Weitere Informationen finden Sie unter REST API Explorer.
Erstellen Sie eine Umsetzungsscriptdatei. Die Scriptdatei enthält die Logik, die die JSON-Antwort in ein kompatibles Format umsetzt, das im Dashboard angezeigt werden kann.
Verwenden Sie die folgende Beispieldatei, um eine neue Scriptdatei für die Antwortumsetzung zu erstellen:
- Beispielscriptdatei: restapi_sample_response_t12n.txt
- Beispieldateiposition: $installationsverzeichnis/wlp/usr/servers/prdapp/restapi_t12n
Dabei ist installationsverzeichnis das Verzeichnis, in dem die Anwendung installiert wurde. Wenn Sie bei der Installation kein anderes Installationsverzeichnis angegeben haben, befindet sich die Anwendung standardmäßig im Ordner /opt/icabi.
Die von Ihnen erstellte Antwortumsetzungsdatei muss die Namenserweiterung .js aufweisen und muss sich an der gleichen Speicherposition wie die Beispieldatei befinden. Der Dateiname darf nicht länger als 100 Zeichen sein. Sie müssen den Namen dieser Antwortumsetzungsdatei im Feld Name des Scripts für die Antwortumwandlung eingeben, wie in den Prozedurschritten im weiteren Verlauf dieses Abschnitts beschrieben.
Wenn Sie für die Beispielanforderung angepasste Header bereitstellen müssen, müssen Sie sicherstellen, dass Ihnen diese Informationen zur Verfügung stehen. Angepasste Header sind Anforderungsheader, die zum Abrufen von REST-API-Informationen von einem Web-Service benötigt werden, wie beispielsweise Anforderungsheader für die Autorisierung oder Anforderungsheader 'Accept-Charset'. Anforderungsheader für die Autorisierung enthalten Berechtigungsinformationen, die für den Web-Service erforderlich sind. 'Accept-Charset' gibt die zulässigen Datenzeichen an, die in der Antwort enthalten sein müssen.

Vorgehensweise

Umsetzungsscriptdatei erstellen.

Führen Sie die folgenden Schritte aus, um eine Umsetzungsscriptdatei zu erstellen:
1. Wechseln Sie in das folgende Verzeichnis, in dem sich die Beispielscriptdatei restapi_sample_response_t12n.txt für die Umsetzung befindet:
  
  $installationsverzeichnis/wlp/usr/servers/prdapp/restapi_t12n
2. Erstellen Sie eine Kopie dieser Datei, benennen Sie die Datei um und öffnen Sie diese Datei in einem beliebigen Texteditor.
3. Löschen Sie den Inhalt der Datei, kopieren Sie das folgende Script und fügen Sie es in die Datei ein:
```
var input;
               var finalJson;
                       var output;
	
               // Parse the input in JSON format
               input = JSON.parse(transformationInput);
        
		
        
               records=input['users']		
		
                       output = JSON.stringify(records);
```
4. Speichern Sie die Datei als JavaScript-Datei mit der Dateierweiterung .js.
  Die Scriptdatei für die Umsetzung wurde erstellt.

REST-konforme New Relic-Web-Services mithilfe des Connectors REST API hinzufügen

Führen Sie die folgenden Schritte aus, um REST-konforme New Relic-Web-Services mithilfe des Connectors REST API hinzuzufügen:
1. Öffnen Sie Dashboard Designer.
2. Rufen Sie im Navigationsbereich Connectors & Quellen > Connectorquellen auf.
3. Klicken Sie auf der Seite 'Alle Connectorquellen' auf Quelle hinzufügen.
  
  Das Fenster Connectorquelle hinzufügen wird angezeigt.
4. Wählen Sie in der Liste Connectortyp den Connector REST-API aus.
5. Geben Sie in das Feld Name der Connectorquelle einen Namen für die Quelle ein.
  
  Der Quellenname kann alphanumerische Zeichen und Unterstreichungszeichen enthalten.
6. Geben Sie in das Feld Endpunkt-URL die URL-Details für den Web-Service in einem der folgenden Formate ein:
  - https://server-IP_oder_hostname:port
  - http://server-IP_oder_hostname:port
  Dabei gilt Folgendes:
  - server-IP_oder_hostname ist die IP-Adresse oder der Hostname des Servers, auf dem der Web-Service gehostet wird.
  - port ist der Standardport des Web-Service. Die Standardportnummer für http-URLs ist 80. Die Standardportnummer für https-URLs ist 443.
7. Wählen Sie in der Liste Authentifizierungstyp die Option Keiner aus.
8. Geben Sie den Namen der Umsetzungsscriptdatei im Feld Name des Scripts für die Antwortumwandlung ein, wenn Sie die Antwort umsetzen wollen.
9. Klicken Sie auf Weiter.
10. Wählen Sie in der Liste Methode die Methode GET aus und geben Sie in das Feld URI den URI (Uniform Resource Identifier) für die Quelle ein.
  
  Beispiel-URI für die Methode GET: /users.json
11. Führen Sie unter Angepasste Header die folgenden Schritte aus:
  - - Geben Sie in das Feld Name den Namen des Anforderungsheaders ein, der vom Provider des REST-API-Web-Service bereitgestellt wird.
      Beispiel: X-Api-Key
    - Geben Sie in das Feld Wert den API-Schlüssel ein, den Sie mit dem New Relic-Konto erstellt haben.
    Wenn Sie weitere Anforderungsheader hinzufügen wollen, können Sie auf Weiteren hinzufügen klicken und die vorherigen Schritte wiederholen.
12. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die Verbindung zur Datenquelle erfolgreich war.
  
  Wenn die Quellendetails und die Beispielanforderung gültig und vollständig sind, wird eine Nachricht angezeigt, die besagt, dass die Verbindung erfolgreich hergestellt wurde. Wird eine Nachricht ausgegeben, die besagt, dass ein Verbindungsfehler aufgetreten ist, müssen Sie die in der Nachricht beschriebenen Fehler beheben und die Verbindung erneut testen.
  Anmerkung: Auch wenn die Quellendetails gültig sind, kann es vorkommen, dass eine Verbindungsfehlernachricht angezeigt wird. Dies ist der Fall, wenn für die Beispielanforderung eine ungültige Antwort empfangen wird.
13. Klicken Sie auf Speichern.

Ergebnisse

Auf der Seite Alle Connectorquellen werden die folgenden Details für jede Connectorquelle angezeigt:

Name der Connectorquelle
Connectortyp
Datum und Uhrzeit der erstmaligen Erstellung der Connectorquelle sowie der Benutzername des Benutzers, der die Quelle anfänglich erstellt hat.
Datum und Uhrzeit der letzten Änderung der Connectorquelle sowie der Benutzername des Benutzers, der die Connectorquelle zuletzt geändert hat. Es wird nur der neueste Datensatz angezeigt.

Der REST-API-Service wird hinzugefügt und kann verwendet werden, um angepasste Datendefinitionen zu erstellen.