Push-Metrik-API

Die Push-Metrik -API bietet Endpunkte, mit denen Integratoren Rohdaten Operational Intelligence aus einer externen Quelle an MID-Serverübertragen können.

Diese API basiert auf clientseitigen Tools, die die Rohdaten aus der externen Quelle an den MID-Serverübertragen . Die Erweiterung Operative Metriken muss mit aktivierter Option REST-Listener aktivieren konfiguriert werden. Weitere Informationen zum Einrichten von MID-Serverfinden Sie unter Erste Schritte mit Operational Intelligence.

Weitere Informationen zu Authentifizierungsanforderungen finden Sie unter MID Web Server-Erweiterung konfigurieren.

Push-Metriken – POST /mid/sa/metrics

Übermittelt Rohdaten Operational Intelligence aus einer externen Quelle an MID-Server.

URL-Format

Standard-URL: /api/mid/sa/metrics

Unterstützte Anforderungsparameter

Tabelle : 1. Pfadparameter

Name	Beschreibung
Keine

Tabelle : 2. Abfrageparameter

Name	Beschreibung
Keine

Tabelle : 3. Anforderungstextparameter (XML oder JSON)

Name	Beschreibung
ci2metric_id	Liste der Schlüssel-Wert-Paare, die zum Identifizieren des Konfigurationselements (CI) verwendet werden sollen Früher wurde sie ci_identifiergenannt . Das Skript akzeptiert weiterhin ci_identifier. Datentyp: Objekt
metric_type	Name der Metrik Datentyp: Zeichenfolge
Knoten	IP-Adresse, FQDN, Name des CI oder Host Im folgenden Beispiel der Name des Linux-Servers, auf dem die Datenträger installiert sind. Datentyp: Zeichenfolge
resource_path	Der Pfad der Ressource, für die Metrikdaten erfasst werden. Im folgenden Beispiel ist C:\ die Ressource, für die Metrikdaten erfasst werden. Datentyp: Zeichenfolge
Quelle	Datenquelle, die den Metriktyp überwacht. Datentyp: Zeichenfolge
timestamp	Epochenzeitstempel der Metrik. Datentyp: Zahl Einheit: Millisekunden
Wert	Metrikwert Datentyp: Zahl

Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.

Tabelle : 4. Anforderungskopfzeilen

Kopfzeile	Beschreibung
Content-Type	Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json

Tabelle : 5. Antwortkopfzeilen

Kopfzeile	Beschreibung
Keine

Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

Tabelle : 6. Statuscodes

Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
401	Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
500	Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

Antworttextparameter (JSON oder XML)

Name	Beschreibung
Keine

Beispiel für eine cURL-Anforderung

curl -X POST "https://servicenow-instance/api/mid/sa/metrics"
-H "Content-Type: application/json"
-U "username":"password"
-d "{
    "metric_type": "Disk C: % Free Space",
    "resource_path": "C:\\",
    "node": "lnux100",
    "value": 50,
    "timestamp": 1473183012000,
    "ci2metric_id": {
        "node": "lnux100"
    },
    "source": "Splunk"
}"