Zur Performance-Überwachung der Client-Anwendung im „Item Management“ kann man durch diese Prozedur (in der Tabelle „Performance“) festhalten, wie lange die Ausführung eines Templates für ein Element des Artikelbaums gedauert hat.
Anmerkungen:
1. Da diese Prozedur EINDEUTIG dem „Item Management“ zuzuordnen ist, müßte der Name der Prozedur eigentlich mit „im“ beginnen und nicht mit „mi“ - aber da der „dStore“ abwärtskompatibel sein muß, ist das leider nicht mehr zu ändern…
2. Die Funktionalität bzgl. Performance-Messung ist nur sehr rudimentär implementiert, da dies eigentlich Aufgabe der jeweiligen Client-Anwendung ist. Zur Auswertung gibt es nämlich derzeit lediglich eine undokumentierte, interne Prozedur : „_mi_GetPerformance“, die also nur vom „dstore“ bzw. „sa“ Benutzer ausgeführt werden kann : Diese ermittelt je nach Parameter „TemplateDurations“ folgendes:
Dabei werden nur die Messungen der letzten „LastXHours“ Stunden berücksichtigt.
HTTP-Method | POST |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | miscellaneous |
Engine-Typ | Daten-Änderung |
Letzte Aktualisierung | 3.5.0 (2000-11-23) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
TreeNodeID | ID eines Elementes im Artikelbaum, für das die Performance des Templates gemessen wurde | integer | 3.5.0 | |
TemplateID | ID eines Templates, das für die Anzeige des Elementes „TreeNodeID“ verwendet wurde und auf das sich die Messung bezieht | integer | 3.5.0 | |
Time_ms | Wie lange (in Millisekunden) hat die Ausführung des Templates „TemplateID“ für das Element „TreeNodeID“ gedauert ? | integer | 3.5.0 |
Die Prozedur hat keine Rückgaben.
Die Prozedur hat keine Output-Parameter.
Die Prozedur hat keine Fehlercodes.
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
3.5.0 | 2000-11-23 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/mi_InsertPerformance_Pu?TreeNodeID=<value>&TemplateID=<value>&Time_ms=<value>'
Mit xmllint 4) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/mi_InsertPerformance_Pu?TreeNodeID=<value>&TemplateID=<value>&Time_ms=<value>' | xmllint --format -
use dStore_php\WebService; $service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80); $request = new WebService\Requests\Engine\Procedure\Request( new WebService\Requests\AccessData('default'), 'mi_InsertPerformance_Pu', array( 'TreeNodeID' => <value>, 'TemplateID' => <value>, 'Time_ms' => <value> ) ); $service->execute($request); $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); $ResultSet = $xml_result->getRowsAsArray();
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="mi_InsertPerformance_Pu"> <Parameters> <Parameter Name="TreeNodeID"><!-- integer value --></Parameter> <Parameter Name="TemplateID"><!-- integer value --></Parameter> <Parameter Name="Time_ms"><!-- integer value --></Parameter> </Parameters> </Procedure> </Batch> </ListOfBatches>