This page allows you to manage data log files and logging schedules.
Event Log
File size: 0K Free space: 209K/246K Status: OK
File name:
File Name:Enable Logging
Log Rate: Log only when register # is greater than zero.
New File:End Time: Size: KBLife: Days
Upon resources exhausted: Discard oldest Stop logging
Recipient:
Subject:
Message:
Click here for log file format information
Quick Help

Use this page to select a directory and file name for the log file indicated at the top. There are a fixed number of "data loggers". This page assigns a file location and name to this data logger. Check the Enable box to turn this data logger on.

The data logger will log at the rate given in HH:MM:SS (hours, minutes, seconds). Logging is disabled if the rate is zero. If the "log only when" register number is zero, logging will be enabled continuously if the enable box is checked and rate is nonzero. If the "log only when" register contains a valid local register number, that register must be greater than zero before logging will be enabled (in addition to checking the enable box). This allows data logging to be tied to a schedule.

Eventually a log file will be come full, and you must decide what to do about that. In addition, available memory resources may be used up by other data loggers. Therefore, it is a good idea to manage all of the data loggers in a coordinated manner, allocating only an attainable size limit to each one.

You have the option of closing one file and starting a new one daily, weekly, or upon file full (size is met). At this point, you can allow the file to sit there until retrieved via FTP, or you can have the data log file automatically emailed as an attachment. If the "discard oldest" option is enabled, you can have a perpetual data logger requiring no particular log-in maintenance (as with FTP). To enable the email feature, enter a recepient email name (myname@myplace.com), a subject line for the email, and an optional message.

The "discard oldest" will discard the oldest file having the given file name as its name prefix. The oldest file will be deleted when there is no longer empty space available for the file size indicated for this log file. This rule applies independently for each log file rule set. Therefore, the event logger will never delete data files for data log #1, etc. The event logger will only delete oldest event log files.

You may find it desirable to delete old log files before you run out of room. To enable this automatically, enter a non-zero number of days for file life. The file will automatically be deleted after this number of days, but only if a new file is created in its place first. If you allow daily files to accumulate until you run out of room, the file list will become very long, and consequently response time for any functions requiring file name lookup becomes slow.

The file name you give above is only the first part of the name that is generated. The file creation date in the format YYYYMMDD is appended to this name. Therefore multiple files with the same "name" given above will still be unique file names. If you change the name after some amount of data has been logged with the old name, you must manually delete the old files. The "discard oldest" rule will only find files by the same name prefix currently defined above.

Log files will be sent at most once daily (unless file size is small and the file fills up). If the end time is later than current time when logging is first enabled, the file will not be sent at that time today; it will be sent at that time tomorrow. Logging daily does not mean you get precisely 24 hours of data. Daily means it will send a log file at most once a day, and never the same day the file was created.

You can log data to either RAM or FLASH memory. Data logged to RAM will be lost if power to this system is lost. The RAM area is known as directory RAM0 and has a capacity of about 200KB. The FLASH area is known as directory FLASH0 and has a capacity of 1.9MB. This FLASH0 area is shared with configuration files and program files. Note that Flash memory has a finite life. If you are logging data to Flash at a frequent rate, you may shorten the life of the product.

The specific rules followed for resource management are as follows:

If a file is full, i.e., its size setting is met, then disregard the schedule, send it now and request a new file. Until the file becomes full, check the schedule. If it should be sent now due to daily schedule settings, send it and request a new file. The "send it" applies only if email is configured (recipient given and server set up), but the new file request will always apply.

When a new file is requested, check the "discard" or "stop" setting. If "discard oldest" is selected, add up all log file sizes. If this much free space is not available, delete the oldest file with a name prefix matching the log configuration requesting a new file. If there are only zero or one older files, revert to "stop logging" rules. If "stop logging" is selected (by configuration or by default), check to see if there is room for 50% of just this file. If so, create it, otherwise disable this log.