Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:mi_insertperformance_pu

mi_InsertPerformance_Pu

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:

  • 0 : Wieviel Prozent der Templates brauchen länger als 0.5, 1 bzw. 3 Sekunden ?
  • 1 : Für jedes Template wird angegeben, wie lange die Generierung im Schnitt bzw. maximal dauerte (in Millisekunden).

Dabei werden nur die Messungen der letzten „LastXHours“ Stunden berücksichtigt.

HTTP-MethodPOST
HTTP-AuthOptional
Tags
Engine-Kategoriemiscellaneous
Engine-TypDaten-Änderung
Letzte Aktualisierung3.5.0 (2000-11-23)

Parameter

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
integer3.5.0
TemplateID ID eines Templates, das für die Anzeige des Elementes „TreeNodeID“ verwendet wurde und auf das sich die Messung bezieht
integer3.5.0
Time_ms Wie lange (in Millisekunden) hat die Ausführung des Templates „TemplateID“ für das Element „TreeNodeID“ gedauert ?
integer3.5.0

Rückgabe

Die Prozedur hat keine Rückgaben.

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Die Prozedur hat keine Fehlercodes.

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

3.5.0 2000-11-23Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

cURL

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 -
dStore_php
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();
engine/execute

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>
1)
Pflichtparameter sind unterstrichen
4)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/mi_insertperformance_pu.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)