Open iT Data Monitor and Alerts

The Open iT Data Monitor and Alerts allows the user to monitor and evaluate the data situation and stability processed in the Core Server. It evaluates the archived data and records each vendor license's daily life count and size. It also processes the license status files to get the number of registered vendor licenses that will be the baseline for sending email alerts.

Data Monitor Processing

The openit_datamonitor binary processes the data used by the Data Monitor. It processes the archive and license status directories to get the file count and size as a basis for data stability.

Configuring Open iT Data Monitor and Alerts

Windows

1. Open a command prompt with Administrator level privileges.

2. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd C:\Program Files\OpeniT\Core\bin

3. Once in the directory, activate the processing of licpoll2 archived data, run the command:

   Command Syntax

   openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:general.active=true

4. To set various parameters defining what the binary will periodically do, run the command:

   Command Syntax

   openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:operations.arguments=<optional_parameters>

   OPTIONS:

   Parameter	Description
   --dir <arg>	Use this to specify the directory path to where the output will be placed. Possible values are: archive - C:\ProgramData\OpeniT\Data\archive licstat - C:\ProgramData\OpeniT\Data\license_status
   -a | --archtype	Use this to specify the archive type of the data that the binary will process. If not specified, all archive will be processed.
   --utc	Use this to use the utc/gmt date configuration.

   Optional Parameters defining Binary Behavior
   
   
   Example

   openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:operations.arguments="--dir licstat"

5. Open the Task Manager.

6. Under Services, restart the OpeniTCoreServerPipeline service.

Unix

1. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd /opt/openit/bin

2. Once in the directory, activate the processing of licpoll2 archived data, run the command:

   Command Syntax

   ./openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:general.active=true

3. To set various parameters defining what the binary will periodically do, run the command:

   Command Syntax

   ./openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:operations.arguments=<optional_parameters>

   OPTIONS:

   Parameter	Description
   --dir <arg>	Use this to specify the directory path to where the output will be placed. Possible values are: archive - the archive directory in the data-dir defined upon installation licstat - the license status directory in the data-dir defined upon installation.
   -a | --archtype	Use this to specify the archive type of the data that the binary will process. If not specified, all archive will be processed.
   --utc	Use this to use the utc/gmt date configuration.

   Optional Parameters defining Binary Behavior
   
   
   Example

   ./openit_yamlinit coreserver update asset process_licpoll2_monitoring.yaml:operations.arguments="--dir licstat"

4. Restart the Open iT Core Server Pipeline service, run the command:

   Command Syntax

   systemctl restart openit-coreserverpipeline

Configuring License Status Data for Data Monitor Processing

Windows

1. Open a command prompt with Administrator level privileges.

2. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd C:\Program Files\OpeniT\Core\bin

3. Once in the directory, activate the processing of license status data, run the command:

   Command Syntax

   openit_yamlinit coreserver update asset process_licenstatus_monitoring.yaml:general.active=true

4. Open the Task Manager.

5. Under Services, restart the OpeniTCoreServerPipeline service.

Unix

1. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd /opt/openit/bin

2. Once in the directory, activate the processing of license status data, run the command:

   Command Syntax

   ./openit_yamlinit coreserver update asset process_licenstatus_monitoring.yaml:general.active=true

3. Restart the Open iT Core Server Pipeline service, run the command:

   Command Syntax

   systemctl restart openit-coreserverpipeline

Executing Data Monitor Manually

Windows

1. Open the command prompt with Administrator level privileges.

2. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd "C:\Program Files\OpeniT\Core\bin"

3. Once in the directory, run the command:

   Command Syntax

   openit_datamonitor <start-date> <end-date>

   REQUIRED PARAMETERS:

   Parameter	Description
   <start-date>	The start of the included dates to process YYYY-MM-DD; if not specified, the default value is the day before the binary execution.
   <end-date>	The end of the included date to process YYYY-MM-DD; if not specified, the default value is the day of the binary execution.

   Required Parameters for Data Monitor Execution
   
   
   Example

   openit_datamonitor 2022-01-01 2023-01-01

   This will get data from January 1, 2022 to January 1, 2023.

   To further customize the command, use the optional parameters.

   Command Syntax

   openit_datamonitor <options> <start-date> <end-date>

   OPTIONAL PARAMETERS:

   Parameter	Description
   --dir <arg>	Use this to specify the directory path to where the output will be placed. Possible values are: archive - the archive directory in the data-dir defined upon installation licstat - the license status directory in the data-dir defined upon installation.
   -a | --archtype	Use this to specify the archive type of the data that the binary will process. If not specified, all archive will be processed.
   --utc	Use this to use the utc/gmt date configuration.

   Optional Parameters defining Binary Behavior
   
   

   Combine or use optional parameters at the same time to achieve necessary capabilities.

   Command Syntax

   openit_datamonitor --dir archive --archtype licpoll2 --utc 2022-01-01 2023-01-01

4. Verify that the AlertMonitoring.db is created in the admin directory, which is by default in C:\ProgramData\OpeniT\Data\admin. This is the default output of the binary.

Unix

1. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd <bin_dir>

   Example

   cd /opt/openit/bin

2. Once in the directory, run the command:

   Command Syntax

   ./openit_datamonitor <start-date> <end-date>

   REQUIRED:

   Parameter	Description
   start-date	The start of the included dates to process YYYY-MM-DD; if not specified, the default value is the day before the binary execution.
   end-date	The end of the included date to process YYYY-MM-DD; if not specified, the default value is the day of the binary execution.

   Required Parameters for Data Monitor Execution
   
   
   Example

   ./openit_datamonitor 2022-01-01 2023-01-01

   This will get data from January 1, 2022 to January 1, 2023.

   To further customize the command, use the optional parameters.

   Command Syntax

   ./openit_datamonitor <options> <start-date> <end-date>

   OPTIONAL:

   Name	Description
   --dir archive	This will point to the archive directory in the data-dir defined upon installation.
   --dir licstat	This will point to the license status directory in the data-dir defined upon installation.
   -a | --archtype	The archive type of the data that the binary will create.
   --utc	The date configuration to use (utc or gmt). If not specified, gmt will be used.

   Optional Parameters defining Binary Behavior
   
   
   warning

   All archive will be processed if archive type is not specified.

   Combine or use optional parameters at the same time to achieve necessary capabilities.

   Example

   ./openit_datamonitor --dir archive --archtype licpoll2 --utc 2022-01-01 2023-01-01

3. Verify that the AlertMonitoring.db is created in the admin directory in your defined data_dir (<root_data_dir>) upon Open iT server installation. This is the default output of the binary.