Help for Foxhound 3.0.4386a

Table of Contents     [RisingRoad]


1. The Foxhound Menu Page

The "Foxhound" home page is called the Foxhound Menu because it lets you choose which target database you want to work with.

1.1 The Foxhound Menu Menu

1.2 The DSN Tab

1.3 The String Tab

1.4 The Monitor Tab


What's New in Foxhound 3

1. Release-Defining Features

2. New Features

3. Usability Improvements

4. Behavior Changes

5. Bug Fixes


1. Release-Defining Features      

  1. Support for SQL Anywhere 16 and OnDemand 1.0 target databases has been added.

  2. The new Connection History page shows the performance of a single connection over time.

  3. The Blocked Connections section of the Foxhound Monitor page has been merged into the Connections section.

2. New Features      

  1. The new Change Target Settings page lets you set RememberLastPlan, RememberLastStatement and RequestTiming.

  2. The Machine, Server, Database names have been added to page titles and Alert messages.

  3. The new OS User column has been added to help identify connections: Conn #, ID, OS User, IP, Name.

  4. The new Busy, Wait, Idle columns have been added for each connection.

  5. The Conns connection count column has been expanded to show Parent and Child Conns.

  6. The new total Waiting Time column has been added to the Foxhound Monitor.

  7. The new Last Plan Text column has been added to the connection section.

  8. The new Favorable? YYY column has been added as a link to open the Change Target Settings window.

  9. You can now specify Purge after [xx] day(s) instead of being limited to 1 day, 1 week, 1 month or 1 year.

  10. The new Purge - Off / After xx days column has been added as a link to the Purge section of the Foxhound Options page.

  11. CPU Time calculations have been improved for connections using intra-query parallelism.

  12. The new total Rollback Log and Uncommitted columns have been added to the Foxhound Monitor page.

  13. The separate Req, Commits and Bytes In/Out columns have been gathered into the new connection-level Volume... Req, Commits, Bytes columns.

  14. The new Connection Id String can be used to uniquely identify connections in adhoc queries; e.g., '1-1-20140504073924-692'.

  15. A new emergency patch process is built in to Foxhound for fixing bugs without running a full upgrade.

  16. Five new Alerts have been added: Database read-only, Database updatable, Rollback log usage, Uncommitted operations and Long uncommitted.

  17. The new DB File and Used columns have been added to the Foxhound Monitor.

3. Usability Improvements      

  1. Major layout changes have been made to the Foxhound Monitor and Sample History pages, including the connection sections.

  2. The new Hide Details and Show Details buttons let you reduce scrolling on the Sample History and Connection History pages.

  3. The new Show More and Show Less buttons let you expand and contract the Last Statement and Last Plan Text connection data.

  4. A new warning about duplicate Foxhound sampling sessions has been added to the Foxhound Monitor page.

  5. The Foxhound option to show the Help frame is turned back on when Foxhound is upgraded, as a reminder that new Help content is available.

  6. Descriptive text has been added to all menu items on the Monitor Options page.

  7. The Peaks since timestamp has radically abbreviated to reduce horizontal scrolling.

  8. Alert email error messages have been improved.

  9. Concise Alert titles are included in all Alert-related messages; e.g., Alert #10: Partner unreachable.

  10. The Foxhound post-setup process has been streamlined.

  11. A new Start Foxhound via default browser shortcut has been added.

  12. There's no more "Can't open Message window log file" message when starting Foxhound.

  13. The Adhoc Schema connection string has been renamed to Foxhound 3 Adhoc Schema - autostart and connect.

  14. The handling of the diagnostic text files produced during the Foxhound Post Setup process has been improved.

  15. Scrolling on the Sample History page is faster.

  16. Color highlighting of Foxhound Monitor data has been improved.

  17. The sampling id and DSN or Connection String name are now appended to all target-related email exception diagnostics.

  18. The Running Time, Waiting Time, Transaction Time and other durations have been abbreviated to make them easier to read.

  19. There are no longer any limitations on the number or names of multiple Extended Edition Foxhound servers.

  20. Some Help topics previously found only in the Foxhound FAQ have been moved to the Help.

  21. The number of processors has been moved from the heading section to the CPU Time xx% of x column, with a link from the Peaks since line.

  22. The HTML generated by Foxhound now works better with the zoom features in Chrome, Firefox and IE.

4. Behavior Changes      

  1. SQL Anywhere 16.0.0.1915 or later is required to run Foxhound 3.

  2. The Cumulative CPU Time and Total Waits columns have been removed from connection-level displays.

  3. The Client Requests, Time columns have been removed from connection-level displays.

  4. The Total, Current Prepares and Rollbacks columns have been removed from connection-level displays.

  5. The Bytes In / Out columns have been removed from connection-level displays and summarized in Volume... Req, Commits, Bytes.

  6. Alert #11 HA failover has been renamed to Alert #11 ServerName change.

  7. The Waiting Req column has been renamed to Unsch Req to reduce confusion with SQL Anywhere documentation.

  8. Alert #14 Waiting Requests has been renamed to Alert #14 Unscheduled Requests.

  9. The Last Statement sort order is only changed when you click on the title text, not the data value.

  10. The security rules are different for connecting to SQL Anywhere 16 target databases.

  11. The dbsrv16 -ufd restart option has been added to the desktop shortcuts to keep Foxhound running.

  12. Foxhound is no longer being extensively tested on Windows XP or IE8.

  13. The Rollbacks column has been removed from database-level displays.

  14. The Checkpoints column has been merged into the Checkpoints, Checkpoint Urgency, Recovery Urgency column set because the values are related.

  15. The Log Writes column has been merged into the Disk Reads, Disk Writes, Log Writes column set because the values are related.

  16. The Free Disk Space Sys, Temp, Log, Other columns have been moved to the heading section because the values don't change very often.

  17. The Throughput... Commits column has been rounded so rates like 0.099/s are displayed as 0.1/s, because the extra precision was not helpful.

5. Bug Fixes      

  1. Support for Snapshot Isolation has been added, thus eliminating the fatal "Cannot convert 'Snapshot' to a decimal" error.

  2. The "Column '@alert11_actual_current_ServerName' not found" error has been fixed.

  3. A bogus Alert #9 Arbiter unreachable is no longer issued for an OnDemand database.

  4. The ALTER MATERIALIZED VIEW statement has been moved after CREATE INDEX on the Display Schema page.

  5. The click here to sort on list has been made version-specific.

  6. A bogus Alert #1 Database unresponsive is no longer issued when Foxhound is started after being upgraded.

  7. The email status is no longer displayed as "Email sent, status unknown." before the attempt to send an email is actually made.

  8. The popup tips for several Alert and AutoDrop criteria fields on the Monitor Options page have been changed to "Percent, 1 to 100".

  9. The minimum input value for the AutoDrop #3 Long transaction duration field on the Monitor Options pages has been changed to 1.0s.

  10. Bad input values entered on the Monitor Options page for integer Alert and AutoDrop criteria fields are now silently changed to the minimum allowed values.

  11. The Foxhound Options - Purge Run report no longer displays 2 as the number of Orphan/Old Sample Set Rows Deleted when no change is reported in the total number of rows.

  12. The Start Foxhound via Chrome shortcut no longer has trouble finding Chrome.

  13. The No Transaction Log curiosity message is no longer displayed for read-only databases.

  14. An error message is displayed instead of suppressing the sample when Foxhound can't call sa_locks() to diagnose a blocked connection.

  15. The handling of invalid SQL Anywhere property values coming from target databases has been improved.

  16. Heartbeat durations are no longer rounded upwards; instead, values between .001s and 0.099s are changed to 0.1s to distinguish them from 0s.

  17. Foxhound no longer tries to AutoDrop the same connection more than once.

  18. The CPOOL=NO connection parameter has been added to the connection string Foxhound uses to connect to target databases.

  19. It is now possible to start Foxhound in Safe Mode when it is run as a service.

  20. Safe Mode startup now marks all timed out sampling sessions as no longer timed out, just stopped.

  21. The Foxhound Options Timeout Retry - never retry setting now works properly.

  22. Concurrent usage of the Global Overrides sections of the Foxhound Options and Monitor Options pages is now properly handled.

[Top]


1.1 The Foxhound Menu Menu    [Top]
Every page has a menu line, even the Foxhound Menu :)

The New Menu link opens the Foxhound Menu page in a new browser window or tab. This link appears on every Foxhound page to make it easy to look at multiple databases at the same time.

The Foxhound Options link opens the Foxhound Options page in a new browser window or tab.

The Monitor Options link opens the Monitor Options page in a new browser window or tab. That page lets you enable and disable different alerts, change the conditions under which alerts are issued and manage multiple Monitor sessions using a tab-delimited file of connection strings.

The button is a context-sensitive link to this Help topic. This button appears in many locations, each of them a link to a different Help topic in this frame.

Tip: To hide the Help for every new page, see the Show Help section on the Foxhound Options page.

The About link opens the About Foxhound page in a new browser window or tab.


1.2 The DSN Tab    [Top]

The DSN tab lets you pick a target database by using an ODBC Data Source.

If you don't have a DSN, and you don't want to create one, try using the String tab instead.

The Choose a DSN: drop-down list lets you pick which DSN you want from all the User and System DSNs recorded in the Windows registry.

Foxhound turns off AutoStart and AutoStop processing as follows:

When Foxhound connects to the target database it uses a connection string that looks like this, where xxx is the DSN you have specified:

   DSN=xxx; AutoStop=NO; AutoStart=NO; ConnectionName=Foxhound-pnnn
or this if you have provided a user id yyy and password zzz:
   UID=yyy; PWD=zzz; DSN=xxx; AutoStop=NO; AutoStart=NO; ConnectionName=Foxhound-pnnn
The AutoStop=NO; AutoStart=NO; ConnectionName=Foxhound-pnnn values override any values specified inside the DSN. The nnn value will be a number 001, 002, etc.

If you want AutoStop and/or AutoStart processing, use the String tab to connect instead of the DSN tab.

The User Id: and Password: fields are optional; you don't need to fill them in if values are stored in the DSN itself.

Check Include system tables if you want the Display Schema page to include the SQL Anywhere catalog tables and views; e.g., ISYSTAB and SYSTABLE.

The button connects to the target database and opens the Display Schema page in the current browser window or tab.

The button opens the Monitor Database page in the current browser window or tab. If a sampling session already exists for this DSN, sample data from that session will be displayed. If not, Foxhound will start a new sampling session and display that data.

The button tells Foxhound to include non-SQL Anywhere DSNs in the Choose a DSN: drop-down, and excludes them again.

The button starts the Windows ODBC Data Source Administrator program so you can edit and create DSNs.

This button is disabled if the Foxhound engine is not running locally. Foxhound can only use the ODBC DSNs that are stored on the same machine that's running the Foxhound engine, so that's where you have to go to run the ODBC Administrator.

This button may not work properly if the Foxhound engine is running as a service on the local computer. In general, services cannot launch interactive user interfaces; e.g., the ODBC Administrator interface.


1.3 The String Tab    [Top]

The String tab lets you pick a target database by specifying the SQL Anywhere connection string. Foxhound always uses ODBC to connect to the target database, but that doesn't mean you need to create a DSN, and this tab makes a DSN-less connection possible.

... but, if you always use DSNs to connect to your database, you probably don't need to use the String tab at all.

The Choose a connection string: drop-down list lets you pick which connection string you want to use. Connections strings are stored in the Foxhound database, and several samples are delivered in the initial setup.

The Enter or edit the connection string... box lets you create, edit and delete your connection strings.

The Name: field lets you specify a name to uniquely identify this connection string in the Foxhound database. Connection string names are separate from DSN names so you can use the same names if you want.

The String: field lets you fill in the connection parameters.

Foxhound changes the default settings for AutoStop and AutoStart from YES to NO, and provides a default connection string name, by appending the following connection parameters to the end of the string you provide (where nnn is a number 001, 002, etc):
   AutoStop=NO; AutoStart=NO; ConnectionName=Foxhound-pnnn
If you provide different values for these parameters in the string you provide, your values will be used because that's the way connection strings are processed: the first value for any parameter is the one that is used.

However, that rule does not apply if you specify a DSN=xxx parameter and code your connection parameter values inside the DSN: the values specified in the outer connection string, including the values appended by Foxhound will be used instead.

Tip: Foxhound comes with several pre-defined connection strings, and later upgrades may add more. Feel free to delete or edit these strings as you wish; depending on how your computer is set up you may have to change some of them so they will work properly.

Tip: To see all the views and tables available for adhoc reporting, select "Foxhound 3 Adhoc Schema - autostart and connect" and click on the Display Schema button.

The button clears the Name: and String: fields.

The button displays several examples of connection parameters, and hides them again. Click on an example to paste it into the String: field.

The button saves the String: field in the Foxhound database with Name: as the identifier. This will do an update or insert depending on whether Name: already exists or not.

The button deletes the connection string identified by Name: from the Foxhound database.

Tip: To rename an existing connection string, type the new Name and Save the string, then Choose and Delete the string with the old name.

The Password: field is optional; you don't need to fill it in if your connection string includes a value.

Check Include system tables if you want the Display Schema page to include the SQL Anywhere catalog tables and views; e.g., ISYSTAB and SYSTABLE.

The button connects to the target database and opens the Display Schema page in the current browser window or tab.

The button saves the connection string and then opens the Monitor Database page in the current browser window or tab. If a sampling session already exists for this connection string, sample data from that session will be displayed. If not, Foxhound will start a new sampling session and display that data.


1.4 The Monitor Tab    [Top]

The Monitor tab lists all the sampling sessions that have been created. When this tab is displayed, it is refreshed every 10 seconds with the most recent data. It is also refreshed whenever you switch to it from the DSN or String tab.

The button starts all the sampling sessions in the list that aren't already running.

If there are a large number of sampling sessions, it might take a while for them to all start.

The Start All Sampling button will not affect any sampling sessions that have a Sample Schedule in effect. If sampling is under the control of a Sample Schedule, you can't stop and start sampling manually, you have to adjust (or turn off) the schedule on the Monitor Options page.

The button stops all the sampling sessions in the list that are currently running.

The Stop All Sampling button will not affect any sampling sessions that have a Sample Schedule in effect. If sampling is under the control of a Sample Schedule, you can't stop and start sampling manually, you have to adjust (or turn off) the schedule on the Monitor Options page.

The button immediately updates the information displayed on this tab without waiting for the regular refresh.

If the display is paused but sampling sessions are running, you can press Refresh Display to show the most recent information without restarting the automatic refresh process.

The (number) in parentheses in the Refresh Display button tells you how many times this page has been refreshed.

The button stops the Monitor page from being refreshed every 10 seconds, and the button starts it again.

Neither button affects the background sampling process one way or the other. For example, if sampling sessions are running and you press Disable Refresh and later press Enable Refresh, the displayed data "catches up" with the most recent information.

The Show Monitor... column displays the DSN: and String: names used to identify the sampling sessions. You can click on one of these links to open the Monitor Database page in a new browser window or tab.

If the SET OPTION PUBLIC.global_database_id statement has been used on a target database to set the GlobalDBId property to a non-default value, that value will be shown in (parentheses) after the DSN: or String: name. This makes it easier to tell different remote databases apart in a replicating (SQL Remote) or synchronizing (MobiLink) environment.

Each History link in the Show... column lets you open the History page for that database in a new browser window or tab.

Each Options link in the Show... column lets you open the Monitor Options page for that database in a new browser window or tab.

The Active Alerts column shows how many Alerts are currently in effect (not yet All Clear or Cancelled) for this database. Values in this column are links that let you jump down to the corresponding Active Alerts... section at the bottom of this page.

The Sampling column tells you whether the sampling session is Running or Stopped.

The Status column tells you if everything is OK with the sampling session, or what kind of problem occurred. A dash "-" is displayed when the session was stopped with the Stop button.

Heartbeat, Conns, Unsch Req:

Locks Held, Conns Blocked:

These numbers are based on the LockCount and BlockedOn properties. The Conns Blocked column will be empty if connection details are not being recorded; see Foxhound Options - Connection sampling threshold.

The CPU Time column shows the percent used during the preceding interval.

This number is based on the following properties: NumLogicalProcessorsUsed, NumProcessorsAvail, NumProcessorsMax and ProcessCPU.

The Temp Space column shows the total amount of temporary space used by all the connections.

Temporary pages are used for many purposes, most often to hold intermediate results during query processing. Even if there is no temporary file, as with an in-memory no write database, temporary space is allocated and used by the engine.

This column is based on the PageSize and TempFilePages properties.

Disk Reads, Writes:

These numbers are based on the DiskRead and DiskWrite properties.

The Stop link lets you stop the sampling session. This doesn't delete the session, it just suspends the sampling process.

The "...Sample Schedule in effect" link may appear instead of Stop, Start and Delete. If sampling is under the control of a Sample Schedule, you can't stop and start sampling manually, you have to adjust (or turn off) the schedule on the Monitor Options page.

The Cancel link may appear instead of Stop. The Cancel button lets you stop further attempts to start or re-start the sampling session. If Foxhound can't connect to the target database, it will keep trying forever, unless you press Cancel or the connection timeout period is exceeded. See the Foxhound Options page for more information on connection timeouts.

The Start link tells Foxhound to try to start the sampling session.

The Delete link will delete the sampling session. This takes effect immediately, and is permanent; the sample data is no longer available for display. Also see the Foxhound Options page for more information on purging old sample data.

Note: The phrase "is permanent" means there is no "cancel" or "undo" facility. It doesn't mean you can't ever gather samples for this database again; you just have click on the Monitor Database button to start another sample session.

Each database with one or more Alerts in effect (not yet All Clear or Cancelled) will have a corresponding Active Alerts... section at the bottom of this page. Each Alert has a link to open a History page for this database showing the corresponding Alert entry.

[Top]



























































[Top]