Delete

Appendix M – Event Logs 

Log files are useful in determining what happened in the past to help troubleshoot and clarify behavior that is not understood. There are several log files that can be enabled in the system:

Event File

The event file is a monthly file that is created in the Archive folder for the month. Its file name is “Evnt_yyyyMM.csv.” This file is always active and cannot be suppressed. For the current month, the file is not compressed and can grow quite large. When the file reaches 5 Mbytes, the oldest 0.5 Mbytes of records of the file and erased and additional new records are appended to the end of the file. This keeps the file from growing without bounds. At the beginning of a new month, the previous month’s event file is compressed, and the file name now becomes “Evnt_yyyyMM.zip”. The compression code makes the zip file in the \temp\ folder, which is in RAM (faster zipping) and then copies it to the archive folder in flash.

Event lines are kept in a buffer and then a group of lines are written to the event file at one time. The following conditions will cause the buffer to be written to flash:

• At the top of every minute
• When the firmware is being updated, just before the reboot.
• If the user requests a reboot or halt
• If the system has a recoverable crash.
• If the system has an unrecoverable crash, it will attempt this before stopping.

Event Line Format: each line has a fixed portion that is always the same and each field is separated with a comma. After the fixed portion there are one or more variable fields that use a key-value format:

1. Fixed 
   1. Date and time = “MM/dd/yyyy HH:mm:ss”
   2. Other fields as needed.
      1. Key=Value data

Examples of some event lines:

Network Traffic Metering

this logs network traffic and posts values every hour.
(Date Time, System, Traffic, Network, Type, Bytes In, Bytes Out, Packets In, Packets Out)

1. Ethernet: type is “ET”
2. Cloud Network Module: type is “NM”
   1. Ethernet: type is “CE”
   2. WiFi: type is “CW”
   3. Cell: type is “CC”
3. BaseManager/AppManager: type is “BM.”
4. FlowStation: type is “FS”
5. SubStations (one line for each one): type is “SS-01.”
6. IOT server: type is “IOT.”

Delete

Substation Connection

1. NU = number
2. SN = serial number
3. MC = MAC address
4. TY = type {SS, RV, or CP}
5. VR = firmware version
6. HW = hardware version
7. TX = text of network path

Delete

Disconnect Entries

For FlowStation & Substations

1. The network path has been appended and the best reason for the disconnect, in this case there was not a reply to a Ping command sent to the SubStation.
2. The options for the Network Path are:
   1. Ethernet
   2. CN_Ethernet
   3. CN_WiFi
   4. CN_Cell
3. The IOT field is only added for connections that use the IOT server.
4. Possible reasons for a disconnect are:
   1. IOT Offline
   2. Socket Closed
   3. No Ping Reply

Delete

Flow Variance

Flow Variance strikes, zones, and mainlines

1. ML = mainline number
2. ZN = zone or list of zones separated by a semi-colon
3. LX = low variance enabled (otherwise, high variance)
4. SJ = strikes detected (not shutdown)
5. SK = strikes towards shutdown
6. TH = variance threshold (percent)
7. AC = actual flow reading (gpm)
8. EX = expected flow value (gpm)

Delete

FlowStation Managed Mainline

• ML = mainline number
• FS = FlowStation variance status (HI, LO, or OK) – reported by FlowStation for the mainline group that includes this mainline on these 3200 controllers
• ZN = zone or list of zones separated by a semi-colon
• LX = low variance enabled (otherwise, high variance)
• SJ = strikes detected (not shutdown)
• SK = strikes towards shutdown
• TH = variance threshold (percent)
• AC = actual flow reading (gpm)
• EX = expected flow value (gpm)

Delete

PumpStation Status

PumpStation hourly status/data event line

1. IP = address of PumpStation
2. PR = pressure (psi)
3. SS = Drive status
4. PD = PID feedback
5. FQ = output frequency
6. AM = output current
7. TM = total run time
8. ER = fault type [total IO count / missed IO count]

Delete

RainGauge line:

Hourly Log & Test Results

1. RG = rain gauge number
2. SN = decoder serial number
3. VT = two-wire voltage drop
4. VK = accumulated, total rain fall
5. VI = hourly rainfall
6. VH = current rainfall rate

Delete

Run Time Results:

Enable with dynamic logging control [PENDING]

1. Program elapsed run time to completion vs. estimated.
2. Program paused time.
3. Program elapsed time was increased by water window.
4. FlowStation mainline wait time before getting water.
5. FlowStation mainline received a fraction of the water that was requested.
6. Flow meter flow and usage
7. Zone or zone group flow rate

Delete

Event log entries for Alarms:

Delete

Configuration Errors

1. Zones not assigned to a mainline.
2. Zones not in a program.
3. Zones with a zero design-flow value.
   1. If local mainline is using manage by flow.
4. Local water source that is enabled and not assigned to a local control point.
5. Local control point that is enabled and not assigned to a local mainline.
6. Control point with a flow meter that has a zero design-flow.
7. Control point with shutdown conditions that does not have a flow meter.
8. Control point with shutdown conditions that does not have a pressure sensor.
9. Local mainline that is enabled and has no zones.
10. Local mainline that is enabled and manage by flow and does not have a design flow.
11. Sensor devices that are not used.
    1. Event switch = not start/pause/stop condition, no empty condition.
    2. Flow meter = not control point.
    3. Moisture sensor = not start/pause/stop condition, no empty condition.
    4. Pressure sensor = not start/pause/stop condition, no empty condition.
    5. Rain Gauge = not start/pause/stop condition.
    6. Temperature sensor = not start/pause/stop condition.
12. Sensor devices that have bad setup values:
    1. Flow meter = K-value is zero.
    2. Pressure sensor = 4mA value is the same as the 20mA value, or the 20mA value is zero.
    3. Rain Gauge = R-value is zero.
13. Valve decoders that are not used: no control point nor booster assignment.
    1. Master Valve.