Extrahieren Sie Metriken über die REST-API

Metriken werden in der ExtraHop REST API durch eine Kombination von identifiziert metric_category, der name, und die object_type. Sie können alle drei Identifikatoren über den Metric Explorer abrufen.

1. Loggen Sie sich in das ExtraHop-System ein über https://<extrahop-hostname-or-IP-address>.
2. Klicken Sie auf das Symbol Systemeinstellungen und dann klicken Metrischer Katalog.
3. In der Typ um das Feld zu filtern, geben Sie den Namen der Metrik ein, die Sie extrahieren möchten, und klicken Sie dann in den Suchergebnissen unten auf den Namen der Metrik.
4. Scrollen Sie im rechten Bereich nach unten zu den REST-API-Parametern und Datensatz Sie die Werte auf.
   Beispielsweise werden die folgenden Informationen für die Metrik HTTP-Serverantworten angezeigt:
   

Als Nächstes müssen Sie den eindeutigen Bezeichner für das Objekt finden, für das Sie Metriken in der REST-API extrahieren möchten. Sie können diese ID über den REST API Explorer abrufen.

1. Navigieren Sie in einem Browser zum REST API Explorer.
   Die URL ist der Hostname oder die IP-Adresse Ihres Sensor oder Konsole, gefolgt von /api/v1/explore/. Wenn Ihr Hostname beispielsweise seattle-eda ist, lautet die URL https://seattle-eda/api/v1/explore/.
2. Geben Sie Ihre REST-API-Anmeldeinformationen Anmeldedaten.
   • Für Sensoren und ECA-VMs klicken Sie auf API-Schlüssel eingeben und fügen Sie dann Ihren API-Schlüssel ein oder geben Sie ihn in das API-Schlüssel Feld.
   • Klicken Sie für RevealX 360 auf Geben Sie die API-Anmeldeinformationen ein und fügen Sie dann die ID und das Geheimnis Ihrer API-Anmeldeinformationen ein oder geben Sie sie in das ID und Geheim Felder.
3. Klicken Sie Autorisieren und klicken Sie dann Schliessen.
4. Klicken Sie auf den Objekttyp, für den Sie Metriken sammeln möchten, z. B. Gerät, Gerätegruppe, Bewerbung, oder Gerät.
5. Klicken Sie HOLEN SIE SICH/<objects>.
   Wenn Sie beispielsweise Messwerte für eine Gerätegruppe extrahieren, klicken Sie auf Abrufen/ Gerätegruppen.
6. Klicken Sie Probiere es aus.
7. Optional: In der Parameter Abschnitt, geben Sie die Suchkriterien für das Objekt an, das Sie suchen möchten.
   Sie können beispielsweise nach Objektnamen, IP-Adressen oder MAC-Adressen suchen. Wenn Sie Schwierigkeiten haben, ein Gerät zu finden, finden Sie unter Finde ein Gerät.
8. Klicken Sie Anfrage senden.
   In der Serverantwort Abschnitt, der Antworttext zeigt Informationen zu jedem Objekt an, das den Suchkriterien entspricht.
9. Notieren Sie sich die Zahl im ID-Feld für das Objekt, für das Sie Metriken sammeln möchten.
   Die ID des folgenden Server lautet beispielsweise 1298:

   [
     {
       "mod_time": 1516639693474,
       "node_id": null,
       "id": 1298,
       "extrahop_id": "fff4c3090a0a0000",
       "discovery_id": "fff4c3090a0a0000",
       "display_name": "server1",
       "description": null,
       "user_mod_time": 1512688149084,
       "discover_time": 1498685400000,
       "vlanid": 0,
       "parent_id": 140,
       "macaddr": "A1:01:01:01:1A:01",
       "vendor": "Mellanox",
       "is_l3": true,
       "ipaddr4": "10.10.10.200",
       "ipaddr6": null,
       "device_class": "node",
       "default_name": "Mellanox 10.10.10.200",
       "custom_name": "server1",
       "cdp_name": "",
       "dhcp_name": "server1.company.com",
       "netbios_name": "",
       "dns_name": "server1.company.com",
       "custom_type": "",
       "analysis_level": 1,
       "activity": []
     }
   ]

   Kopieren

Sie können Metriken über den REST API Explorer abfragen, um sicherzustellen, dass Sie den richtigen Anforderungstext konfiguriert haben, bevor Sie die Anfrage zu einem Skript hinzufügen.

1. Klicken Sie im REST API Explorer auf Vermögenswerte, und klicken Sie dann auf POST /Metriken.
2. klicken Probiere es aus.
3. In der Körper Feld, geben Sie die Metrik an, die Sie extrahieren möchten.
   Der folgende Text extrahiert beispielsweise Fünf-Minuten-Metriken zu HTTP-Antworten für einen Server mit der ID 1298:

   {
     "metric_category": "http_server",
     "metric_specs": [
       {
         "name": "rsp"
       }
     ],
     "object_type": "device",
     "object_ids": [
       1298
     ],
     "cycle": "5min"
   }

   Kopieren

   Der Körper muss die folgenden Parameter enthalten:

   Objekttyp: Der Objekttyp, für den Sie Metriken sammeln möchten.

   Objekt-IDs: Die ID des Objekts, für das Sie Metriken extrahieren möchten.

   metrische_Kategorie: Die Kategorie der Metrik, die Sie erfassen möchten.

   Name: Der Name der Metrik, die Sie erfassen möchten.

   Zyklus: Der Aggregationszeitraum für Metriken.

4. klicken Anfrage senden um die Anfrage an Ihren Sensor oder Ihre Konsole zu senden.
   In der Antwort des Servers Abschnitt, der Antworttext zeigt die angeforderten Metriken im JSON-Format an.

Das ExtraHop GitHub-Repository enthält ein Python-Skript, das die Gesamtzahl der HTTP-Antworten extrahiert, die ein Server mit der ID 1298 in Zeitintervallen von fünf Minuten gesendet hat, und die Werte dann in eine CSV-Datei schreibt.

1. Gehe zum ExtraHop Codebeispiele GitHub-Repository und laden Sie das herunter extract_metrics/extract_metrics.py Datei auf Ihrem lokalen Computer.
2. Öffnen Sie in einem Texteditor den extract_metrics.py archivieren und ersetzen Sie die Konfigurationsvariablen durch Informationen aus Ihrer Umgebung.
   • Geben Sie für Sensoren und ECA-VMs die folgenden Konfigurationsvariablen an:

     GASTGEBER: Die IP-Adresse oder der Hostname des Sensor oder der ECA-VM.

     API-SCHLÜSSEL: Der API-Schlüssel.

   • Geben Sie für RevealX 360 die folgenden Konfigurationsvariablen an:

     GASTGEBER: Der Hostname der RevealX 360-API. Dieser Hostname wird auf der RevealX 360 API Access-Seite unter API-Endpunkt angezeigt. Der Hostname beinhaltet nicht /oauth2/token.

     ID: Die ID der RevealX 360 REST-API-Anmeldeinformationen.

     GEHEIM: Das Geheimnis der RevealX 360 REST-API-Anmeldeinformationen.

3. Führen Sie den folgenden Befehl aus:

   python3 extract_metrics.py

   Kopieren

   Hinweis:

   Wenn das Skript eine Fehlermeldung zurückgibt, dass die TLS-Zertifikatsüberprüfung fehlgeschlagen ist, stellen Sie sicher, dass Ihrem Sensor oder Ihrer Konsole wurde ein vertrauenswürdiges Zertifikat hinzugefügt. Alternativ können Sie das hinzufügen verify=False Option zur Umgehung der Zertifikatsüberprüfung. Diese Methode ist jedoch nicht sicher und wird nicht empfohlen. Der folgende Code sendet eine HTTP GET-Anfrage ohne Zertifikatsüberprüfung: requests.get(url, headers=headers, verify=False) Kopieren