Description

PointLogExt is an extension for auditing changes in the output of a point. It uses the btibCore log system (see Logs), which makes it possible to use the different existing recipients (console, history, etc.).

We can therefore use several of these extensions on different points to be able to create an event log for a complete entity (for example, grouping the different events of the same AHU in a single history)


Implementation

  • Drag and drop the extension from the palette into a point

Properties

  • Status: The status of the component. It can produce a fault if there is a runtime error
  • FaultCause: describes the origin of the fault in case of problem
  • Enabled: Enables or disables log creation
  • LogGroups: Defines to which LogGroup(s) the logs will be sent (see  Logs). The LogGroup severity is an additional parameter that allows log severity to be filtered by LogGroup.
  • Severity: The severity upon which the extension's logs will be sent (before any possible filter added in LogGroups).
  • ConverterType: The type of converter to be used to create the log message (the list depends on the type of point). This allows you to send different messages depending on the point. PointLogExt uses the same mechanism as animations in .px
  • Converter: The converter chosen by the previous property. Decides the content of the log message. The Input for the converter is the parent point


AdvancedConfig properties

  • InhibitTimeOnStart: Sets an inhibition time during which no log will be sent when starting the station
  • ChangeTolerance: This property appears only for numeric points. It allows a log to be sent only when the difference between the current value and the value of the last log exceeds a certain threshold.
    • Example with a ChangeTolerance of 30:
    • 15.0 {ok}: Send log
    • 25.0 {ok}: Nothing
    • 40.0 {ok}: Nothing
    • 50.0 {ok}: Send log

Example


With this PointLogExt, any change in the output of the point will log the displayName of the parent point and its out value. 


Note

  • The PointLogExt must be placed last among the other extensions in order to take into account the different modifications of the other extensions on the value and the status of the point. If other extensions have been added later, the PointLogExt will automatically switch back at the next restart of the station.