Anzeigen von Performance-Metriken mithilfe von APIs
Active IQ Unified Manager stellt Ihnen unter der Kategorie APIs zur Verfügung /datacenter
, mit denen Sie die Performance-Daten der Cluster und Storage-Objekte in einem Datacenter anzeigen können. Diese APIs rufen Performance-Daten der unterschiedlichen Storage-Objekte wie Cluster, Nodes, LUNs, Volumes, Aggregate, ab. Storage-VMs, FC-Schnittstellen, FC-Ports, Ethernet-Ports und IP-Schnittstellen.
Die /metrics
APIs und /analytics
bieten unterschiedliche Ansichten der Performance-Metriken. Dabei lassen sich diverse Detailebenen für die folgenden Storage-Objekte im Datacenter anzeigen:
-
Cluster
-
Knoten
-
Storage-VMs
-
Aggregate
-
Volumes
-
LUNs
-
FC-Schnittstellen
-
FC-Ports
-
Ethernet-Ports
-
IP-Schnittstellen
In der folgenden Tabelle wird ein Vergleich zwischen dem und /analytics
APIs hinsichtlich der Angaben zu den abgerufenen Leistungsdaten erstellt /metrics
.
Metriken | Analysen |
---|---|
Performance-Details für ein einzelnes Objekt. Zur API muss beispielsweise der |
Performance-Details für mehrere Objekte desselben Typs in einem Datacenter. Die API ruft beispielsweise |
Beispiel für Performance-Kennzahlen für ein Storage-Objekt auf Basis des Zeitungsintervalls für den Abruf. |
Der aggregierte Nutzwert der Performance auf hoher Ebene für einen bestimmten Storage-Typ für einen bestimmten Zeitraum (über 72 Stunden). |
Grundlegende Details des Objekts werden abgerufen, z. B. Details zu einem Node oder Cluster. |
Es werden keine Details abgerufen. |
Akkumulierte Zähler, wie z. B. Minimum, Maximum, 95. Perzentil und die durchschnittlichen Performance-Werte über einen Zeitraum, werden für ein einzelnes Objekt wie Lesen, Schreiben, gesamt und andere Zähler abgerufen. |
Für alle Objekte desselben Typs wird ein einzelner aggregierter Wert angezeigt. |
Der Zeitbereich und die Probendaten basieren auf dem folgenden Zeitplan: Dem Zeitbereich für die Daten. Beispiele können 1 h, 12 h, 1d, 2d, 3d, 15 D, 1 w, 1 m, 2 m, 3 m, 6 m Sie erhalten 1 Stunde Proben, wenn der Bereich mehr als 3 Tage (72 Std.), sonst sind es 5 Minuten Proben. Der Zeitraum für jeden Zeitbereich ist wie folgt:
|
Über 72 Stunden. Die Dauer, über die diese Probe berechnet wird, wird im ISO-8601-Standardformat dargestellt. |
Ausgabebeispiel für Kennzahlen-APIs
Die API ruft beispielsweise /datacenter/cluster/nodes/{key}/metrics
die folgenden Details (unter anderem) für einen Knoten ab:
Das 95 Perzentil im Zusammenfassungswert zeigt an, dass 95 % der für den Zeitraum erfassten Proben einen Zählerwert haben, der unter dem als 95 Perzentil angegebenen Wert liegt. |
{ "iops": { "local": { "other": 100.53, "read": 100.53, "total": 100.53, "write": 100.53 }, "other": 100.53, "read": 100.53, "total": 100.53, "write": 100.53 }, "latency": { "other": 100.53, "read": 100.53, "total": 100.53, "write": 100.53 }, "performance_capacity": { "available_iops_percent": 0, "free_percent": 0, "system_workload_percent": 0, "used_percent": 0, "user_workload_percent": 0 }, "throughput": { "other": 100.53, "read": 100.53, "total": 100.53, "write": 100.53 }, "timestamp": "2018-01-01T12:00:00-04:00", "utilization_percent": 0 } ], "start_time": "2018-01-01T12:00:00-04:00", "summary": { "iops": { "local_iops": { "other": { "95th_percentile": 28, "avg": 28, "max": 28, "min": 5 }, "read": { "95th_percentile": 28, "avg": 28, "max": 28, "min": 5 }, "total": { "95th_percentile": 28, "avg": 28, "max": 28, "min": 5 }, "write": { "95th_percentile": 28, "avg": 28, "max": 28, "min": 5 } },
Ausgabebeispiel für Analyse-APIs
Die API ruft beispielsweise /datacenter/cluster/nodes/analytics
die folgenden Werte (unter anderem) für alle Knoten ab:
{ "iops": 1.7471, "latency": 60.0933, "throughput": 5548.4678, "utilization_percent": 4.8569, "period": 72, "performance_capacity": { "used_percent": 5.475, "available_iops_percent": 168350 }, "node": { "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a", "uuid": "95f94e8d-8b4e-11e9-8974-00a098e0219a", "name": "ocum-infinity-01", "_links": { "self": { "href": "/api/datacenter/cluster/nodes/37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a" } } }, "cluster": { "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a", "uuid": "37387241-8b57-11e9-8974-00a098e0219a", "name": "ocum-infinity", "_links": { "self": { "href": "/api/datacenter/cluster/clusters/37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a" }, "_links": { "self": { "href": "/api/datacenter/cluster/nodes/analytics" } } },
Liste der verfügbaren APIs
In der folgenden Tabelle werden Details zum und /analytics
APIs beschrieben /metrics
.
Die durch diese APIs zurückgegebenen IOPS- und Performance-Metriken sind beispielsweise doppelte Werte |
HTTP-Verb | Pfad | Beschreibung |
---|---|---|
|
|
Ruft die Performance-Daten (Beispiel und Zusammenfassung) für ein Cluster ab, das vom Eingabeparameter des Cluster-Schlüssels angegeben wurde. Informationen wie der Cluster-Schlüssel und die UUID, der Zeitbereich, IOPS, Durchsatz und die Anzahl der Proben werden zurückgegeben. |
|
|
Ruft Performance-Kennzahlen auf hoher Ebene für alle Cluster in einem Datacenter ab. Sie können Ihre Ergebnisse nach den erforderlichen Kriterien filtern. Werte wie aggregierte IOPS, Durchsatz und Erfassungszeitraum (in Stunden) werden zurückgegeben. |
|
|
Ruft Performance-Daten (Beispiel und Zusammenfassung) für einen Node ab, der durch den Eingabeparameter des Node-Schlüssels angegeben wurde. Informationen wie Node-UUID, Zeitbereich, Zusammenfassung der IOPS, Durchsatz, Latenz und Performance, die Anzahl der erfassten Proben und der verwendete Prozentsatz werden zurückgegeben. |
|
|
Ruft High-Level-Performance-Metriken für alle Nodes im Datacenter ab. Sie können Ihre Ergebnisse nach den erforderlichen Kriterien filtern. Informationen wie Node- und Cluster-Schlüssel und Werte wie aggregierte IOPS, Durchsatz und Erfassungszeitraum (in Stunden) werden zurückgegeben. |
|
|
Ruft Performance-Daten (Probe und Zusammenfassung) für ein Aggregat ab, das durch den Eingabeparameter des Aggregatschlüssels angegeben wurde. Informationen wie z. B. Zeitraum, Zusammenfassung der IOPS, Latenz, Durchsatz und Performance-Kapazität, die Anzahl der für jeden Zähler gesammelten Proben und der Prozentsatz der genutzten Kapazität werden zurückgegeben. |
|
|
Ruft Performance-Kennzahlen auf höchster Ebene für alle Aggregate in einem Datacenter ab. Sie können Ihre Ergebnisse nach den erforderlichen Kriterien filtern. Informationen wie Aggregat- und Cluster-Schlüssel und Werte wie aggregierte IOPS, Durchsatz und Erfassungszeitraum (in Stunden) werden zurückgegeben. |
|
|
Ruft Performance-Daten (Beispiel und Zusammenfassung) für eine LUN oder eine Dateifreigabe (Volume) ab, die vom Eingabeparameter der LUN- oder Volume-Taste angegeben wurde. Informationen, z. B. eine Zusammenfassung des minimalen, maximalen und durchschnittlichen Lese-, Schreib- und Gesamt-IOPS, der Latenz und des Durchsatzes Und die Anzahl der Proben, die für jeden Zähler gesammelt wurden, wird zurückgegeben. |
|
|
Ruft Performance-Kennzahlen auf höchster Ebene für alle LUNs oder Volumes eines Datacenters ab. Sie können Ihre Ergebnisse nach den erforderlichen Kriterien filtern. Informationen wie Storage-VM- und Cluster-Schlüssel und Werte wie aggregierte IOPS, Durchsatz und Erfassungszeitraum (in Stunden) werden zurückgegeben. |
|
|
Ruft die Performance-Daten (Beispiel und Zusammenfassung) für eine Storage-VM ab, die durch den Eingabeparameter des Storage-VM-Schlüssels angegeben wurde. Zusammenfassung der IOPS basierend auf jedem unterstützten Protokoll, wie |
|
|
Abruf von Performance-Metriken auf höchster Ebene für alle Storage VMs in einem Datacenter Sie können Ihre Ergebnisse nach den erforderlichen Kriterien filtern. Informationen wie Storage-VM-UUID, aggregierte IOPS, Latenz, Durchsatz und der Erfassungszeitraum (in Stunden) werden zurückgegeben. |
|
|
Ruft die Leistungskennzahlen für einen bestimmten ethernet-Port ab, der durch den Eingabeparameter des Portschlüssels angegeben wird. Wenn ein Intervall (Zeitraum) aus dem unterstützten Bereich angegeben wird, gibt die API die kumulierten Zähler zurück, z. B. Minimum, Maximum und die durchschnittlichen Leistungswerte über den Zeitraum. |
|
|
Ruft die grundlegenden Performance-Kennzahlen für alle ethernet-Ports in Ihrer Datacenter-Umgebung ab. Informationen wie der Cluster- und Node-Schlüssel und die UUID, Durchsatz, Erfassungszeitraum und Prozentsatz der Auslastung für die Ports werden zurückgegeben. Sie können das Ergebnis nach den verfügbaren Parametern filtern, wie z. B. Portschlüssel, Auslastungsgrad, Cluster- und Node-Name und UUID. |
|
|
Ruft die Leistungskennzahlen für eine bestimmte Netzwerk-FC-Schnittstelle ab, die vom Eingabeparameter des Interface Key angegeben wird. Wenn ein Intervall (Zeitraum) aus dem unterstützten Bereich angegeben wird, gibt die API die kumulierten Zähler zurück, z. B. Minimum, Maximum und die durchschnittlichen Leistungswerte über den Zeitraum. |
|
|
Ruft die grundlegenden Performance-Kennzahlen für alle ethernet-Ports in Ihrer Datacenter-Umgebung ab. Informationen wie der Schlüssel für die Cluster- und FC-Schnittstelle und die UUID, Durchsatz, IOPS, Latenz und Storage VM werden zurückgegeben. Sie können das Ergebnis nach den verfügbaren Parametern filtern, z. B. dem Namen des Clusters und der FC-Schnittstelle und der UUID, Storage VM, Durchsatz usw. |
|
|
Ruft die Performance-Metriken für einen bestimmten FC-Port ab, der durch den Eingabeparameter des Port-Schlüssels angegeben wurde. Wenn ein Intervall (Zeitraum) aus dem unterstützten Bereich angegeben wird, gibt die API die kumulierten Zähler zurück, z. B. Minimum, Maximum und die durchschnittlichen Leistungswerte über den Zeitraum. |
|
|
Ruft die grundlegenden Performance-Metriken für alle FC Ports in Ihrer Datacenter-Umgebung ab. Informationen wie der Cluster- und Node-Schlüssel und die UUID, Durchsatz, Erfassungszeitraum und Prozentsatz der Auslastung für die Ports werden zurückgegeben. Sie können das Ergebnis nach den verfügbaren Parametern filtern, wie z. B. Portschlüssel, Auslastungsgrad, Cluster- und Node-Name und UUID. |
|
|
Ruft die Leistungskennzahlen für eine Netzwerk-IP-Schnittstelle ab, die durch den Eingabeparameter des Schnittstellenschlüssels festgelegt wurden. Wenn ein Intervall (Zeitraum) aus dem unterstützten Bereich bereitgestellt wird, gibt die API Informationen zurück, wie z. B. die Anzahl der Proben, angesammelte Zähler, Durchsatz und die Anzahl der empfangenen und übertragenen Pakete. |
|
|
Ruft die Performance-Kennzahlen auf hoher Ebene für alle Netzwerk-IP-Schnittstellen in Ihrer Datacenter-Umgebung ab. Informationen wie der Schlüssel zum Cluster und die IP-Schnittstelle und die UUID, Durchsatz, IOPS und Latenz werden zurückgegeben. Sie können das Ergebnis nach den verfügbaren Parametern filtern, z. B. den Namen der Cluster- und IP-Schnittstelle und die UUID, IOPS, Latenz, Durchsatz usw. |