Untersystem für Nutzung
Die Dienste im Untersystem für Nutzung bieten Ausführungsstatistiken. Die folgenden Informationen können durch Verwendung der Dienste in diesem Untersystem erzielt werden:
• Zeit (in Millisekunden) für Abschluss der Ausführung durch einen Dienst (Minimum, Maximum und Mittelwert)
• Anzahl der Dienstausführungen
• Die JavaScript-Dienste und -Abonnements, die aufgrund eines Timeouts beendet wurden. Weitere Informationen finden Sie unten unter Statistiken zur Skriptausführung, die aufgrund eines Timeouts beendet wurde.
• Die Zeit, die Ding-Abonnements bis zum Abschluss der Ausführung benötigt (Minimum, Maximum und Mittelwert) benötigen.
Durch Verwendung des WriteStatisticsReport-Dienstes kann eine CSV-Datei, die diese Statistiken enthält, in den Ordner ThingworxStorage geschrieben werden.
 |
Statistiken werden nur für abgeschlossene Dienste bereitgestellt. Ein Dienst, dessen Ausführung, die noch nicht abgeschlossen wurde, wird nicht in die Statistiken eingeschlossen.
|
|
Parameter
|
Standard
|
Beschreibung
|
||
|---|---|---|---|---|
|
Zeitstatistiken aktivieren
|
false
|
Wenn dies aktiviert ist, sammelt die Plattform Statistiken. Wenn dies deaktiviert ist, geben die Dienste keine Statistiken zurück.
|
||
|
Arbeitsspeichergröße-Statistiken aktivieren
|
false
|
Wenn dies aktiviert ist, erfasst die Plattform Arbeitsspeichergröße-Statistiken. Wenn dies deaktiviert ist, geben die Dienste keine Statistiken zurück. Derzeit sammelt die Plattform, sofern aktiviert, nur Informationen zur Arbeitsspeicherstatistik des Abonnementstatus für das Statusobjekt Sortiertes Abonnement.
|
||
|
Zeitstatistiken anzeigen
|
true
|
Zeitstatistiken werden angezeigt.
|
||
|
Arbeitsspeichergröße-Statistiken anzeigen
|
false
|
Arbeitsspeichergröße-Statistiken werden angezeigt.
|
||
|
Entitätsnamen-Aggregation aktivieren
|
true
|
Wenn mehrere Entitäten denselben Dienst verwenden, werden aggregierte Statistiken für die Dienste angezeigt.
|
||
|
Quantile anzeigen
|
false
|
Zeigt zusätzliche Statistiken für Perzentile in der Konfigurationstabelle an.
|
|
|
Die Konfiguration Statistiken-Persistenz aktivieren ist im Untersystem für Nutzung nicht verfügbar. Auf einem aktualisierten System sind persistente Protokolle bis zum Zeitpunkt des Upgrades in der Datenbank verfügbar und können abgefragt werden. Nach dem Upgrade ist die Statistiken-Persistenz nicht verfügbar, und die neuesten Statistiken werden nach einem Neustart von ThingWorx Platform nicht beibehalten. PTC empfiehlt, die Dienste zum Schreiben in Dateien zu verwenden, z.B. WriteEntityServiceStatisticsReport, WriteEntityStatisticsReport usw.
|
UtilizationStatistics-Dienste
|
Dienst
|
Beschreibung
|
||
|---|---|---|---|
|
GetAuthenticationStatistics
|
Gibt Daten dazu zurück, wie viele Authentifizierungen für alle angegebenen Authentifizierungstypen aufgetreten sind und ob sie erfolgreich waren oder fehlgeschlagen sind. Authentifizierungstypen enthalten Formularanmeldungs-Authentifikatoren, einfache HTTP-Authentifikatoren, Anwendungsschlüssel-Authentifikatoren, SSO-Authentifikatoren und benutzerdefinierte Authentifikatoren.
|
||
|
GetEntityServiceStatistics
|
Gibt Mindestwert, Maximalwert, Mittelwert und Anzahl der Dienstausführungen für jede Entität zurück.
|
||
|
GetEntityStatistics
|
Gibt ein Kombinationsfeld der Statistiken in den Diensten GetEntityServiceStatistics und GetEntitySubscriptionStatistics zurück.
|
||
|
GetEntitySubscriptionStatistics
|
Gibt Zeit- und/oder Arbeitsspeichergröße-Statistiken (Minimum, Maximum, Durchschnitt, Anzahl) für die Ausführung von Abonnements für Ereignisse für Entitäten zurück.
|
||
|
GetPropertyVTQCount
|
Gibt die Anzahl der Eigenschaften zurück, die durch die Abfragekriterien angegeben werden. Weitere Informationen finden Sie unter Dienst "GetPropertyVTQCount" verwenden.
|
||
|
GetQueryStatistics
|
Gibt die Abfragestatistiken zurück. Weitere Informationen finden Sie unter Abfragestatistiken.
|
||
|
GetStatistics
|
Gibt alle Statistiken in den Diensten GetEntityServiceStatistics, GetEntitySubscriptionStatistics und GetAuthenticationStatistics zurück. Enthält minimale Zeit, maximale Zeit, durchschnittliche Zeit und Anzahl für jeden ausgeführten Dienst. Abonnements können auch Arbeitsspeicher-Statistiken einschließen.
|
||
|
ResetAuthenticationStatistics
|
Setzt die Authentifizierungsstatistiken zurück.
|
||
|
ResetEntityServiceStatistics
|
Setzt Entitätsdienststatistiken zurück.
|
||
|
ResetEntityStatistics
|
Setzt Entitätsstatistiken zurück.
|
||
|
ResetQueryStatistics
|
Setzt Abfragestatistiken zurück. Weitere Informationen finden Sie unter Abfragestatistiken.
|
||
|
ResetStatistics
|
Setzt alle Statistiken zurück.
|
||
|
ResetEntitySubscriptionStatistics
|
Setzt die Abonnementstatistiken für eine Entität zurück.
|
||
|
WriteAuthenticationStatisticsReport
|
Schreibt eine eindeutig benannte CSV-Datei an den folgenden Speicherort: ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntityServiceStatisticsReport
|
Schreibt eine eindeutig benannte CSV-Datei an den folgenden Speicherort: ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntityStatisticsReport
|
Schreibt eine eindeutig benannte CSV-Datei an den folgenden Speicherort: ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntitySubscriptionStatisticsReport
|
Schreibt eine eindeutig benannte CSV-Datei an den folgenden Speicherort: ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteQueryStatisticsReport
|
Schreibt die Abfragestatistiken. Weitere Informationen finden Sie unter Abfragestatistiken.
|
||
|
WriteStatisticsReport
|
Schreibt eine eindeutig benannte CSV-Datei an den folgenden Speicherort: ThingworxStorage/reports/UtilizationStatistics
|
Benennungsmuster für Statistiken
Das Benennungsmuster lautet wie folgt:
• Alle Statistiken werden unter dem Präfix twx.stats gesammelt.
• Authentifizierungsstatistiken werden unter twx.stats.authentication gesammelt.
• Entitätsstatistiken werden unter twx.stats.entity gesammelt.
• Entitätsdienststatistiken werden unter twx.stats.entity.<Entitätsname>.services.<Dienstname> gesammelt.
• Entitätsabonnementstatistiken werden unter den folgenden Namen gesammelt: twx.stats.entity.<Entitätsname>.subscriptions.<Abonnementname>.
• Abfragestatistiken werden unter twx.stats.query gesammelt.
Die Parameterdatentypen für die "Benennung" für die Dienste enthalten Folgendes:
• Präfixe: Fügen Sie diese zum Starten des Dienstes hinzu, für den Statistiken zurückgegeben werden sollen. Um beispielsweise nur Authentifizierungsstatistiken anzuzeigen, verwenden Sie das Präfix twx.stats.authentication für den Dienst GetStatistics, oder verwenden Sie den praktischen GetAuthententicationStatistics-Dienst ohne Parameter.
• Reguläre Ausdrücke: Sie können für Entitätsnamen und Dienste verwendet werden. Sie können alle Entitäten anzeigen, die ein Regex-Muster befolgen, wenn die Aggregationsoption deaktiviert ist. Sie können auch einen Regex verwenden, um bestimmte Dienste anzuzeigen, die mit dem Wort Get beginnen. Das verwendete Regex-Muster folgt dem Java-Regex-Muster, das unter https://docs.oracle.com/javase/8/docs/API/java/util/regex/Pattern.html dokumentiert ist.
Statistiken zur Skriptausführung, die aufgrund eines Timeouts beendet wurde
ThingWorx Platform beendet Skripts mit langer Laufzeit und meldet die Aktion dem Plattformprotokoll. ThingWorx Platform sammelt auch Statistiken zu jeder Skriptbeendigung, die durch ein Timeout verursacht wird. Die Statistiken werden aufgezeichnet, wenn die Ausführungszeit den konfigurierten Skript-Timeout-Wert überschreitet. Die Plattform sammelt die Statistiken für Dienste und Abonnements, die in JavaScript geschrieben wurden.
|
|
Standardmäßig ist die Einstellung für das Skript-Timeout für die ThingWorx Plattform 30 Sekunden. Wenn das Skript länger ausgeführt wird, beendet die Plattform die Ausführung. Ein ThingWorx Administrator kann das Skript-Timeout im Abschnitt "Basic Settings" der Konfigurationsdatei platform-settings.json konfigurieren. Siehe auch platform-settings.json – Konfigurationsdetails.
|
Die Statistiken werden in die Ergebnisse der folgenden Dienste im Untersystem für Nutzung eingeschlossen:
• GetStatistics
• GetEntityStatistics
• GetEntityServiceStatistics
• GetEntitySubscriptionStatistics
• WriteStatisticsReport
• WriteEntityStatisticsReport
• WriteEntityServiceStatisticsReport
• WriteEntitySubscriptionStatisticsReport
Die Timeout-Statistiken sind für Dienste verfügbar, die das folgende Benennungsmuster verwenden:
twx.stats.entity.<entity-name>.services.<service-name>.timedout
Entsprechend sind Timeout-Statistiken für Abonnements verfügbar, die das folgende Benennungsmuster verwenden:
twx.stats.entity.<entity-name>.subscriptions.<subscription-name>.timedout
Diese timedout-Statistiken verfolgen Vorkommen und Zeitdauerstatistiken, wenn für die angegebenen Skripts ein Timeout auftritt.