Active Roles administrators can enable diagnostic logging at the request of support personnel to assist them in finding root causes of issues that occur during Active Roles operations. The diagnostic information includes the Active Roles configuration statistics (referred to as Active Roles system summary), the Active Roles Administration Service diagnostic log and the Active Roles Console diagnostic log.
The Active Roles Administration Service’s diagnostic log (ds.log) contains tracing information, such as API calls, internal function calls and state transitions performed by the Administration Service. This information is stored in the ds.log file that you can send to the support team for issue diagnostic purposes. Two logging levels are available: Basic and Verbose. The Verbose option writes much more information to the log, which can aid in the process of isolating an issue. However, with the increase in verbosity comes a corresponding decrease in performance and increase in the size of the log file.
The Active Roles Console’s diagnostic log (EDMSnap.txt) contains debugging information specific to the Active Roles Console, this can be helpful in isolating Console-related issues.
You can use the Active Roles Console to perform the following tasks:
-
Export Active Roles system summary.
This option allows you to save the Active Roles configuration statistics to a file that you can later send to the support team for diagnosing the issue.
-
Turn the Administration Service’s diagnostic log on or off.
The Console shows the path to the log file located on the computer running the Administration Service.
-
Choose the level of verbosity for the Administration Service: Basic or Verbose.
The Verbose option results in a more detailed log, but considerably increases the size of the log file.
-
Turn the Console’s diagnostic log on or off.
The Console shows the path to the Console’s log file on the local computer.
It is also possible to enable or disable diagnostic logs by using Configuration Center (see Logging management tasks). The following instructions apply to the Active Roles Console.
To view or change the diagnostic settings
-
Log on as an Active Roles Admin, and open the Active Roles Console.
-
In the Active Roles Console tree, click the root node to display the Active Roles summary page in the details pane.
-
On the summary page, expand the Diagnostics area.
In the Diagnostics area, you can view whether the Active Roles Administration Service’s diagnostic logging is currently enabled (turned on) or disabled (turned off).
-
In the Diagnostics area, click View or change diagnostic settings.
This opens the Diagnostics page in the Properties dialog for the Administration Service instance to which the Console is currently connected. Another way to open that page is by directly opening the Properties dialog from the Administration Service object in the Configuration/Server Configuration/Administration Service container.
-
Use the Diagnostics page to perform the following tasks:
-
To turn the Administration Service’s log on or off, click the appropriate option. This option enables or disables the Administration Service diagnostic logging on the computer running the Administration Service instance to which the console is currently connected.
-
Choose the level of verbosity from the Logging level list, if you have selected the option to turn on the Administration Service’s log.
-
View the path and name of the Administration Service’s log file, along with the name of the computer that holds the log file.
-
Click the appropriate option to turn on or off the Console’s log. This option enables or disables the console diagnostic logging on the local computer.
-
View the path and name of the Console’s log file, along with the name of the computer that holds the log file.
-
-
Click Export Active Roles system summary to save the Active Roles configuration statistics to a file that you can later send to the support team for diagnosing the issue.
-
When finished, click OK or Apply for your changes to take effect.