SUPERVALU Einstein Diagnostic and Logging Service Reference Guide Version 1.0 September, 2009 TRADEMARKS SVHarbor and the SVHarbor logo are registered trademarks of SUPERVALU in the United States and may be protected as trademarks in other countries. Their respective companies claim all other products, services or company names mentioned herein as trademarks and trade names. SUPERVALU, 2009 Einstein Reference Guide Version 1.0 Contents Welcome .......................................................................................................................................... 1 Obtaining Access to Einstein Application .................................................................................... 1 Before You Begin – Background Information .................................................................................. 1 The Einstein Home page ................................................................................................................. 2 Using the Search Logs Function ..................................................................................................... 3 Using the Manage Machine Settings Function ................................................................................ 6 Exiting Einstein ................................................................................................................................ 9 Welcome This document describes accessing and using the Einstein application used to review logged events of handheld devices as well as servers operating within or through the SVHarbor environment. Please be sure to read through this manual in its entirety to ensure your understanding of how to use the Einstein application to search for and review logs. If you have an administrator role, you can also set the logging level of the machines supplying data to the logs database. Obtaining Access to Einstein Application The Einstein application is available after you login to SVHarbor. Access to the Einstein application is limited to designated read-only users and administrators of the application. The corporate SVHarbor administrator will grant access to the application after security has approved your access request. Before You Begin – Background Information Most applications available in the SVHarbor portal have the internal capability of capturing an event log as various application activities occur. Historically, support personnel would have to manually access or request transfer of those log files in order to troubleshoot errors or erratic activities. As part of the Einstein application, devices (handhelds as well as servers) being used as part of other applications can now be configured to automatically capture and send parts or all of their log files to a shared database for querying. The Einstein application also allows users to search for the log database using a variety of criteria. i Einstein Reference Guide Version 1.0 The Einstein Home page The graphic and callouts below provide an overview of the Home page of the Einstein application. There are two types of users of the application: read-only users and administrators. Both read-only users and administrators will access the same application and functions. Both will be able to search and view logs. While read-only users will only view machine settings, administrators will be able manage (change logging levels) them. Search Logs option Manage Machine Settings option NOTE: Although the Einstein application is designed to operate in screen resolutions as small as 1024 X 768 the screen captures in this document were made using a 1280 X 1024 resolution. Both the Search Logs function and the Maintain Machine Settings function are discussed in detail below. 2 Einstein Reference Guide Version 1.0 Using the Search Logs Function When you select the Search Logs option from the Einstein Home page, the Search Logs page is displayed. The Search Logs page allows you to enter criteria to retrieve a limited list of logged events. NOTE: Log events are maintained in the database for approximately two weeks before they are purged by an application process. To access all logs currently in the database for viewing, click Search. To apply criteria to limit the list of logs to view, enter or select from any or all of the following: (Keep in mind that the more criteria you apply, the fewer number of items will be included in the results because the items returned must match all criteria.) Date (MMDDYY) User Security Enter a starting and Through date (or click the Calendar icon to locate and select the dates*). You can enter a starting date only to use today’s date as the Trough date. You can also use only a Through date to include all dates prior to it in the database. Enter the User ID of a user. Select a severity level from the dropdown list. Selections are: Fatal Only Fatal events Error Error and Fatal events Warning Warning, Error, and Fatal events Debug Debug, Warning, Error, and Fatal events 3 Einstein Reference Guide Version 1.0 Trace Application Categories Machine ID Contains Message Contains Trace, Debug, Warning, Error, and Fatal events All All captured events Accept the default “Any…” or select an application from the dropdown list (currently, only one can be selected.). By default, all categories are selected. Deselect the checkbox for any category to exclude. Selections are: Business Business type exceptions. Ex.: failed validations. Heartbeat Health of server or device. Ex.: Signal strength, Battery life, Disk space. Performance Performance issues. Ex.: Login errors, Slow response, Timeouts Security Security. Ex.: Attempts to login with bad credentials or when not authorized. Technical System issues. Ex.: System deadlock, Out of memory, Database down Enter a string of letters and/or numbers of a machine ID. Enter a string of letters and/or numbers to be found in the message. When you have entered your criteria, click Search. The application will process and return a list of log events that match your criteria. A sample is shown below. To condense the list to only the record headers and a brief description of the logged event, click the Hide stack traces link ( ). 4 Einstein Reference Guide Version 1.0 The application will process and redisplay the page as shown below. To display the stack traces again, click the Show stack traces link ( ). You can navigate through the pages of a lengthy listing using the VCR-like controls at the bottom of the page. (See graphic below.) You can also select the number of log events to display on a page using the Logging events to display: dropdown. (See graphic below.) Use these controls to navigate the pages of the listing. Use this dropdown to set number of events to display per page. 5 Einstein Reference Guide Version 1.0 Using the Manage Machine Settings Function When you select the Manage Machine Settings option from the Einstein Home page, the Manage Machine Settings page is displayed. The Manage Machine Settings page allows you to enter criteria to retrieve a list of machines (handhelds and servers). Support personnel and administrators can view the log severity settings for machines in the list. Administrators can also change the settings for a machine or for what is transferred to the database. To access all machines currently logged in the database for viewing, click Search. To apply criteria to limit the list of machines to view, enter or select from any or all of the following: (Keep in mind that the more criteria you apply, the fewer number of items will be included in the results because the items returned must match all criteria.) Application Machine ID Contains Machine Logging Severity Accept the default “Einstein” for all applications or select an application from the dropdown list. (Currently, you can select only one.) Enter a string of letters and/or numbers of a machine ID. Accept the default “Any…” for all severities or select a severity level from the dropdown list. Selections are: Off Fatal Error Warning Only Fatal events Error and Fatal events Warning, Error, and Fatal events 6 Einstein Reference Guide Version 1.0 Debug Einstein Logging Severity Debug, Warning, Error, and Fatal events Trace Trace, Debug, Warning, Error, and Fatal events All All captured events Accept the default “Any…” for all severities or select a severity level from the dropdown list. Selections are: Off Fatal Error Warning Debug Trace All Only Fatal events Error and Fatal events Warning, Error, and Fatal events Debug, Warning, Error, and Fatal events Trace, Debug, Warning, Error, and Fatal events All captured events NOTE: The Logging Severity can be set for the events that are captured in the individual machine’s log as well as for which of those events are transferred to the Einstein database. The severity levels need not be the same; however; those of the machine must be set lower or the same as Einstein. When you have entered your criteria, click Search. The application will process and return a list of log events that match your criteria. A sample, as viewed by an Administrator, is shown below. Read only users will see inactivated dropdowns in the Machine Severity and Einstein Severity columns. 7 Einstein Reference Guide Version 1.0 Administrators can modify the Machine Severity and/or Einstein Severity settings of any machine in the list by making a selection from the appropriate dropdown. The dropdown selections are as follows: Off Fatal Error Warning Debug Trace All Only Fatal events Error and Fatal events Warning, Error, and Fatal events Debug, Warning, Error, and Fatal events Trace, Debug, Warning, Error, and Fatal events All captured events NOTE: The Logging Severity can be set for the events that are captured in the individual machine’s log as well as for which of those events are transferred to the Einstein database. The severity levels need not be the same; however; those of the machine must be set lower or the same as Einstein. You can navigate through the pages of a lengthy listing using the VCR-like controls at the bottom of the page. (See graphic below.) You can also select the number of machines to display on a page using the Logging settings to display: dropdown. (See graphic below.) Use these controls to navigate the pages of the listing. Use this dropdown to set number of events to display per page. 8 Einstein Reference Guide Version 1.0 Exiting Einstein There are two ways to exit the Einstein application: To exit the Einstein application and return to the SVHarbor Home page, click the SVHarbor link in the lower right of the page. (See graphic below.) To exit the Einstein application and SVHarbor, click the Logout link at the top right of the page. (See graphic below.) Logout link SVHarbor link 9