Dokumentation
UC_ResetLogMessageStatistics
bool UC_ResetLogMessageStatistics (int $InstanzID)
Parameterliste
| InstanzID | ID zum Util Control |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion setzt alle Zähler von UC_GetLogMessageStatistics auf 0 und ResetTimeStamp auf den aktuellen Zeitpunkt. Danach wird nur noch gezählt, was ab diesem Zeitpunkt ins Log geschrieben wird.
MessageTimeStamp bleibt unverändert. Die gespeicherten Meldungen von UC_GetLastLogMessages bleiben ebenfalls erhalten, sie werden mit UC_ResetLastLogMessages gelöscht.
Die ID der Util Control Instanz liefert z.B. IPS_GetInstanceListByModuleID mit der Modul-GUID {B69010EA-96D5-46DF-B885-24821B8C8DBD}. Existiert InstanzID nicht, schlägt die Funktion mit "Instance #... does not exist" fehl, gehört die Instanz zu einem anderen Modul, mit "Instance does not implement this function".
Beispiel
// ID der Util Control Instanz ermitteln
$id = IPS_GetInstanceListByModuleID('{B69010EA-96D5-46DF-B885-24821B8C8DBD}')[0];
UC_ResetLogMessageStatistics($id);
// Ab jetzt neu zählen
echo 'Gezählt wird seit ' . date('d.m.Y H:i:s', UC_GetLogMessageStatistics($id)['ResetTimeStamp']);