Chroniker TaskWatch Module – Database Test

Problem:
You don’t know if your databases (Oracle, mySQL, Informix, InterBase, Postgre SQL, are on or offline.  Queries are failing, but you don’t know when.

Solution:
Chroniker's TaskWatch will test exactly how long it takes to run an SQL query against your database.

Creating a Database Task involves the following steps:

  1. Define a Database Task
  2. Create Reactions
  3. Create Events
  4. Apply Events to Database Task

 

Define a New Database Test

 

1. Click on the Add Task button and select Database Test.

 

2. Click on the Group drop down menu button and select a group from this list or create a new one.
If you already have the needed group defined, select that group, and proceed to Step 3




a. Type a unique name in the Group Alias field.
Example: Database Name and type of Task and its number “Northwind_DB1”.  All spaces and symbols are permitted.

b. Type numerical value in the Check Frequency (minutes) in its field. This is how often this test should be run.
Example: The default is 10 minutes, but can go as low as one minute.

c. Select a profile from the drop down list if you have a known period of downtime.
Example: Leave "select" there for continuous monitoring.

d. Enter the number of seconds before the test is considered a failure in the Connect Time-out (sec.) field.
Example: Recommended value is 15-30.

e. Enter a description of the scenario so that you and other users know the purpose of the scenario.
Example: “Northwind database 10 minute testing.”

f. Click the Add button at the bottom of the page when finished, or the Reset button to clear the values.


 

3.Alias:
Enter a unique name for the task in the Task Name field. Use whichever naming convention is most useful to you.
Example: MySQL_OHS

4.Database Type:
Select the Database type from the drop down menu
Example: Microsoft SQL Server

5. Host:
Enter the host name or IP address for the database server in the Host field. Not needed for Oracle or ODBC.
Example: 194.256.15.12

6. Port:
Enter the numerical port number for the database in the Port field. Not needed for oracle or ODBC.
Example: 3306

7. Login/Password:
Enter a valid user name and password for the database in the Login and Password fields.
Example:  This is for secure databases only. Also make sure that you already have the proper permissions from the machine Chroniker is installed on to the database you are trying to run queries on.

8. Timeout (seconds):
Enter a number for the time it takes before the database is considered unavailable in the Time-out (seconds) field.
Example: 10sec

9.Database Name:
Enter the instance name of the database in the database name field. For Oracle, it should be the TNS-Name. For ODBC, it should be the DNS.
Example: “Northwind”

10.Query to Execute: Enter a query to execute.  Basic syntax is required
Example: SELECT TOP 10 * FROM [dbo].[Orders];

11. Event Management:
Select an event from the drop list for each event type.
Example: Drop lists show events you have defined already, OR skip this step and create and apply Events later.

12. Click the Add button at the bottom of the page to complete the creation of task. Or if you want to start over, click the Reset button to clear all fields. You may also click Cancel to abort the process.

 

 

Create Reactions

Reactions are initiated when the tasks’ thresholds are exceeded.  Emails, Numerical Pages, SNMP Traps and Custom are available.

 

1. Click on the Reactions link from the top menu of any module to open the Reactions home page.

Example: The main reaction page is displayed.

2. Click the Add New Reaction button.

3. Choose the type of reaction you want from the list.
Example: Choose e-mail reaction.

Example: This displays the add e-mail reaction page.

4. Type the Reaction Alias. This is the unique name given to the reaction.
Example: MS_SQL_Reaction_Email.  If you are going to use this same email for several tests, make the alias more generic.

4. Type the E-mail address.
Example: Separate multiple E-mail addresses with commas.

5. Type text into the subject field. This is the subject line of the E-mail to be sent.
Example: Insert one or more alert variables.  Select the variable from the drop down list and then click the Add button next to it for each.  “%al has exceeded its %th threshold.”

6. Type the text message that will appear in the body of this E-mail alert.

Example: Insert variables as desired by selecting the variable from the drop down list and clicking Add Button. Do this for each variable you wish to add. “The %al task has %be its %at level at %sd.  It has reached this %th with a value of %vl. “

7. Click the Add button at the bottom of the page.

 

 

Create Events

An Event is primarily defined by its event (alert) level: Down, Error, Warning or Information. Other important parameters in an event definition are thresholds and reactions. 

Example: Create an event for each event type so that you have three thresholds of monitoring, and an additional one for when the test is down completely. Or you can create very generic events and apply them to several tasks you’ll create in the future.

1. Click Events from the top menu. 

Example: The main events page is displayed.

2. Click Add new Event. 
Example: The add event page is displayed.

3. Type in the event name.  Event names can use any convention you find most helpful.  Example: msql_db_Info. Make sure that each is unique to avoid confusion.

4. Select the event type from the drop list.
Example: Information.

5. Select the operator from the drop list.  The mathematical operator used to compare the retrieved value and the threshold
Example: (>, <, >=, <=, +, -, =).

6. Type in the numerical duration the threshold must be exceeded for to initiate this event.
Example:
300

7. Type in the numerical threshold. 
Example: If you choose the operator “>”, than “800” may be a good value.  Do not set thresholds so low that you constantly receive an e-mail, only at a level where you actually do want to.

8. Select reaction(s) #1 and #2 (if necessary). 
Example: Use “mssql_Reaction_Email”, or a reaction that you created earlier.

9. Type an alert message and include variables from the drop list as needed. 
Example: Test %al, has %be at %sd.  This is a  %at alert.

10. Type an event description. 
Example: “This is an information event for the select DB orders test.”

11. Click the add button at the bottom of the page when data is correct.
Example: Newly created event is listed.

Example: If the column data is not helpful in determining what the event is for, edit that event.

 

 


Apply Events

You may apply events either from the main event page, or the edit page of each task you create.  Once applied, as the thresholds are exceeded the reactions are initiated.

 

Apply Event from Event Page

1. Click the Apply button for the event you’ve created.
Example: The apply event page is displayed.

2. Click the name/alias of the task(s) you want to apply the event to. It gets highlighted.
Example: If no monitors are listed, then you do not have that type of test set up yet.

3. Click the apply button at the bottom.
Example: A success screen should appear.

3. Click the continue button.

Apply Event from Task Edit Page

1. Click Tasks button from the top menu.

2. Click the edit task icon for a Database Task. (Icon looks like a small notepad)

3. Select the event you’ve created on the information level of event management from the dropdown list.

4. Click the update button at the bottom of the page.

 

 

Summary

 

You have created a Database Task that will send an email when the event threshold you’ve set is exceeded.  It is recommended that you create as many reactions and events as you need to monitor your systems and networks efficiently.

 

If you find that you are receiving emails constantly, edit the event’s threshold accordingly.  Or make changes to the Database so that it does operate under desired thresholds

 

Now that you have a basic Database test setup, you can graph, report and monitor the data you are collecting.  You may also edit the appropriate scenario and or task to include profiles and other options.

 

Should you need further technical help on the topic of Database monitoring with Chroniker’s TaskWatch module, feel free to contact NRG Global at: 1-626-478-2138 or email: support@NRGglobal.com.