1. Introduction
The monitoring status job setting page in Geosens allows you to:
Select instrument(s) or station group(s) to monitor
Define monitoring frequency -- expected number of readings for a specified timeframe
Schedule monitoring checks to verify reading records
These functions ensure systematic monitoring and help identify discrepancies in data collection.
2. Page Navigation
Expand Monitoring Status → click Monitoring Frequency Settings.
3. How to Create a New Monitoring Frequency Job
3.1 Step A: Access the Settings Panel
Click on ‘+New’ on the top right corner function bar.
A new Monitoring Frequency Setting panel will display at the 2nd half of the page. Scroll down to access it.
3.2 Step B: Filter out instruments / station groups
At the left-hand side panel, monitoring instruments / station groups can be selected and configured by types, status, and time. Filling the fields:
Field Name | Explanation |
Monitoring Status Check Name | A unique name for this monitoring status job. Example: BH-PKG. |
Category | Select specified categories to narrow down the instruments / station-groups. Example: DownSide, WESTLOCSITE – to filter out all instruments / station-groups that are in this category only. |
Instrument / Station-Group | To narrow down the selection list by selecting whether it is instrument(s) or station-group(s) to be monitored. |
Instrument / Station-group Type | To narrow down the instruments / station-groups by selecting the type of instrument / station-group used for frequency monitoring. Example: Disto Displacement Sensor (Triaxial) (WiSen). |
Start Date-Time | Defines when the monitoring check begins, marking the start of the time range for monitoring frequency check. Example: 01-01-2021 21:41:11 – Marks the starting time point for a monitoring check. This is particularly useful for instant Run/Execution of the Job for the data in the past. NOTE: If the field is left empty, no Start time limit is applied to this job, meaning all time is included in this job. |
End Date-Time | Establishes when the monitoring check concludes, setting the endpoint for the time range being analyzed. Example: 31-12-2021 21:41:11 – Indicates the ending time point for a monitoring frequency check. This is particularly useful for instant Run/Execution of the Job for the data in the past. NOTE: If the field is left empty, no End time limit is applied to this job, meaning all time is included in this job. |
Admin Only (Checkbox) | By default, the Admin Only option is unticked, so the monitoring status results can be viewed by authorized project users. If the Admin Only checkbox is ticked, its monitoring status results will only be visible to project administrators. |
Disabled (Checkbox) | Indicates this monitoring frequency check job is inactive/disabled when ticked. |
To Count Data Records With | Tick to count data records even which is in the status of On-Hold, In Quarantine, and/or Disqualified. For example, when the On-Hold option is unticked, record with On-Hold will not be counted as a valid data for the monitoring frequency.
Example: The above settings mean data records which are in the status of ‘On-Hold’, ‘In Quarantine’, and ‘Disqualified’ will be taken into account as a part of monitoring frequency check. |
Overdue or Over Read | By default, the system only captures Overdue situation.
NOTE: Geosens captures overdue by default.
Example: The above settings mean both Overdue and Over Read status will be captured into outstanding items. |
3.3 Step C: Instruments Included / Excluded
At the Middle Upper part of the page, there is an Instrument section for the project users to select Instruments to include and/or exclude in this Job.
Type the name or partial of name in the search field to narrow down the list and click on specified instrument(s) to add it into Selected Instruments or Selected Excluded Instruments List.
Selected Instruments List:
Note 1: if no instrument is selected and appear in the Selected Instruments list, all instruments inside selected Categories and/or Type will be included in this monitoring status job.
Note 2: if there are some instruments selected in the Selected Instruments list, only these selected instruments will be taken into account for this Job.
Selected Excluded Instruments List:
Note 1: if no instrument is selected and appear in the Selected Excluded Instruments list, no particular instrument should be excluded inside Selected Instruments list, Categories and/or Type in this monitoring status job.
Note 2: if there are some instruments selected in the Selected Excluded Instruments list, these Instruments should not be taken into account for this Job.
3.4 Step D: Scheduler with Time Particular
At the Middle Bottom part of the page, there is a Scheduler with Time Particular section.
Each Time Particular option is described below.
Field | Explanation |
Time Boundary | To set up a specific time boundary (i.e. hours, minutes, second) within the period of monitoring scan if necessary. Both From and To Times are nullable.
Example 1: 9:30 to 23:00 → Only data readings taken within the time boundary, 9:30am to 23:00pm in a day will be taken into account in this Monitoring Frequency Check.
Example 2: Leave the fields empty. → 24 hrs, i.e. 00:00:00 to 24:00:00 in a day will be set by default. |
Start Day | Start Day of the Week: when the period to scan is setup as N Week(s), this field is to define which day is the Start day of the Week.
Start Day of the Month: when the period to scan is setup as N Month(s), this field is to define which day is the Start day of the Month.
Configure the system to scan data from the last specified period, such as one week, counting back from the scheduled job execution time. Period To Scan = number + time unit (wk, day, hr, minutes, etc) + starting day of the week + starting day of the month. The fields are optional and will only need to be filled in certain scenarios.
Example 1: 1 + week + Monday + Empty → It means Geosens will count 1 week back from the scheduled job execution time and count starting from Monday.
Example 2: 1 + Months + empty + 1st of the month → it means Geosens will count 1 month back from the scheduled job execution time and count starting from the 1st of the month. |
Period To Scan | Period To Scan = A number + Time unit (Minutes, Hours, Days, Weeks, & Months) |
Job Schedule | To set up a schedule when the monitoring job will conduct. Example: The below settings indicate that the monitoring job will conduct every month, every day at 14:00pm. |
Time Boundary & Period To Scan & Job Schedule | *The three settings must be time-consistent and logically aligned, avoiding any duplicates or overlaps that could confuse Geosens. Example 1 on interactive settings: The above settings indicate: The monitoring status job will execute on 1st each month, and the monitoring scan time range is the last 1 month. Therefore, the scanning time range will be: 1st of last month to 1st of current month when the job is executed.
Example 2 on interactive settings: The above settings indicate: The monitoring status job will execute on 1st each month, and the monitoring scan time range is the last 2 weeks starting on Monday. |
3.5 Step E: Monitoring Frequency Settings
At the right-hand side panel, monitoring frequency will be set to configure the expected number of readings in a certain schedule:
Fields | Explanation |
Frequency Type | Select the time unit of the schedule to receive expected readings. E.g. Minutes, hours, days, weeks, months. |
Data Period | Select the number of time in schedule to receive expected readings. Example: The below schedule is set as every 12 hours. |
Number Readings | Enter a number to set the expected number of readings. Example: The below setting indicates: it is expected to capture 20 readings in every 12 hours. |
Month Selection | Optional Field: Select certain month(s) to set a month limit to the schedule. Example: The below setting indicates: it is expected to capture 20 readings in every 12 hours ONLY on January and March. |
Day Selection | Optional Field: Select certain day(s) to set a day limit to the schedule. Example: The below setting indicates: it is expected to capture 20 readings in every 12 hours ONLY on 1st Jan, 5th Jan, 1st March, and 5th March. |
+Add | Click on ‘+Add’ to add another monitoring frequency setting condition. Note: Geosens will evaluate conditions using an 'OR' logic operator. Example: The below settings show: It is expected to capture 20 readings in every 12 hours on 1st Jan, 5th Jan, 1st March, and 5th March; OR to capture 10 readings in every 12 hours on 1st Feb, 5th Feb, 1st April, and 5th April. |
4. Complicate Scenarios to Create a New Monitoring Schedule
A. To monitor in a monthly time
Example: To conduct the monitoring status job on 1st of each month, and to monitor all readings in the past 1 month; Additionally, the expected monitoring frequency should be 20 readings per month.
The settings are shown below:
Please click on ‘Create’ to open a new monitoring status job setting panel.
For the monitoring status Start Date-Time and End Date-Time, leave them empty as no time limit is required.
For the Monitoring status job schedule, please leave Time Boundary as empty because not required; please set Period To Scan as 1 Month, to ask Geosens to look back to the last 1 month for monitoring check; please set Job Schedule to every month on the 1st day, to ask Geosens to execute this monitoring status job on every 1st of the month.
For the Monitoring Frequency Settings, Please set as 20 readings per month, as instructed.
B. To monitor a certain time period in the past
E.g. To view the certain year 2021 only, when the construction was conducted. The expected monitoring frequency was 1 reading per day.
The settings are shown below:
Please click on ‘Create’ to open a new monitoring status job setting panel.
For the monitoring status Start Date-Time and End Date-Time, 01-01-2021 and 31-12-2021 should be set.
For the Monitoring status job schedule, please leave them empty, because this job does not require any sequencing in future. It is a one-time job.
For the Monitoring Frequency Settings, please set 1 reading per day as instructed.
Please click on ‘Create’ at the bottom of the panel to save this setting.
In the data grid, tick to select this monitoring status job that just created, and click on ‘Run’ at the top right corner function bar.
This monitoring status job will execute right away, regardless of the job scheduling (if have any).
5. Monitoring Status Job Data Grid - Columns
This section explains each column in the data grid and how to read the table.
Field Name | Explanation |
Id | Unique identifier for the monitoring job. |
MF Pack Name | Name of the monitoring status job setting package. |
Instrument/Station-Group | Indicates whether it is the instrument or Station-group as the type to be monitored. |
Category | To display the category to which the monitored instrument or station group belongs. |
Instrument/Station-Group Type | Specific type of instrument / Station-group used in monitoring. |
Start Date time | Starting date and time for the monitoring schedule. |
End Date time | Ending date and time for the monitoring schedule. |
Enabled | Indicates whether the monitoring job is active or not. |
Admin Only | Tick if the setting is restricted to admin users. |
pToScanValue | This is the time number of period to scan. E.g. 1,2,3,… |
pToScanUnit | This is the time unit of period to scan. E.g. day / minute / hours… Period to Scan = pToScanValue + pToScanUnit. Example: pToScanValue = 1; pToScanUnit = Day. → It means the time period of monitoring scan will be 1 day. Geosens will count for the number of readings within 1 day time for monitoring check. |
Schedule | The time scheduled to conduct this monitoring job. |
Notes | Additional notes related to this monitoring job. |
Updated By | Email address of the person who last updated the job setting. |
Updated On | Date and time when the setting was last updated. |
Additional columns can be dragged and dropped from the column chooser into the data table to customize the view and add more information.
Field Name | Explanation |
Start Time | The last date and time when the monitoring job is conducted. |
End Time | The last date and time when the monitoring job is completed. |
On Hold | Tick means to count data records that are in On-Hold Status. |
In QT | Tick means to count data records that are in the Quarantine Status. |
Disqualified | Tick means to count data records that are in Disqualified Status. |
To Capture Overdue | Tick means to count data records that are overdue and failed to be captured into Geosens than expected. |
To Capture Over Reads | Tick means to count data records that are overread and been additionally captured into Geosens than expected. NOTE: If none of ‘capture overdue’ nor ‘capture over reads’ been ticked, Geosens will capture overdue by-default. |
Instruments/Station-Groups | Lists the name of instruments or groups of stations involved in this monitoring job. |
Instrument/Station-Groups to be Excluded | Lists the name of instruments or groups of stations excluded in this monitoring job. |
Created By | The email address of the person who created this monitoring job. |
Created On | The date and time when the person created this monitoring job. |
6. Monitoring Status Job Data Grid - Functions
This section introduces the basic functions from the top right corner tool bar.
Function Name | Description |
Edit Grid | Turn into inline edit mode, so users can click on the table cell to make changes directly. |
New | To create a new monitoring status job setting. A new setting panel will appear at the bottom of the page if scroll down. |
Edit | Tick on an existing monitoring job row, and click on ‘Edit’ to open the existing setting panel at the bottom of the page to make any changes. |
Copy | Tick on an existing monitoring job row, duplicates the selected item to the data table. |
Run | Tick on an existing monitoring job row, executes this monitoring status job right now on demand, regardless the job scheduled execution time. Example: In some scenarios, user wants to check readings in a certain period of time in the past, e.g. To view the certain year 2021 only, when the construction was conducted. The expected monitoring frequency was 1 reading per day. The settings are shown below:
|
Delete | Tick on an existing monitoring job row, removes the selected job from the list permanently. |
7. Other Common Workflows
A. Column Chooser - Viewing More Information
Utilize the Column Chooser ‘
’ to select which data columns to display for a more comprehensive view.
Drag and drop columns into the data grid to focus on the information most pertinent to your analysis.
B. Filtering Function – Filtering for Specific Frequency Job
Click on the filtering icon '
', type in the key words to narrow down records, tick on one or multiple items in the list to apply the filter.
C. Sorting Function – Sorting for Specific Monitor Status Job
Click on column headers to sort your data.
Toggle between ascending and descending order to enhance data management efficiency.
D. Editing an Existing Monitor Status Job
Click on ‘Edit Grid’ or tick an existing monitoring status job row and select ‘Edit’ from the top right corner function bar, to open the existing setting panel at the bottom of the page and modify specific details.
E. Copy an Existing Monitor Status Job
Select an existing monitoring status job row, click ‘Copy’ function from the top right corner function bar, to duplicate existing monitoring status job settings, and make few changes as needs.
H. Run an Existing Monitor Status Job
Tick an existing monitoring status job row to select it. Click ‘Run’ in the top right corner function bar to conduct the monitoring status job on demand, regardless of the job scheduled execution time.
Example: In some scenarios, user wants to check readings in a certain period of time in the past, e.g. To view the certain year 2021 only, when the construction was conducted. The expected monitoring frequency was 1 reading per day.
The settings are shown below:
Click on ‘Create’ to open a new monitoring status job setting panel.
For the monitoring status Start Date-Time and End Date-Time, 01-01-2021 and 31-12-2021 should be set.
For the Monitoring status job schedule, please leave them empty, because this job does not require any sequencing in future. It is a one-time job.
For the Monitoring Frequency Settings, please set 1 reading per day as instructed.
Please click on ‘Create’ at the bottom of the panel to save this setting.
In the data grid, tick to select this monitoring status job that just created and click on ‘Run’ at the top right corner function bar.
This monitoring status job will execute right away, regardless of the job scheduling (if have any).
I. Delete an Existing Monitoring Status Job
To remove outdated or unnecessary monitoring status job setting using the delete function.
Tick to select the existing monitoring status setting job row from the table. Click on ‘Delete’ from the top right corner function bar, to delete the job permanently.