ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

Configuring and collecting verbose logs for the CCS Application Server/manager from the CCS 12.6 console

book

Article ID: 239617

calendar_today

Updated On:

Products

Control Compliance Suite Control Compliance Suite Standards Server

Issue/Introduction

Control Compliance Suite (CCS)

In CCS 12.6 and newer versions, in the CCS console you can set verbose logging for your Application Server and remote managers in the CCS console, and then use the Console to zip up and remotely collect the files from the different CCS components and save them to a user-defined location.

NOTE: See 'Additional Information' below for the KB on how to set verbose logging on CCS 12.5.X versions:

Environment

CCS v12.6 or newer release

Resolution

To set the Log Severity to Verbose on the Application Server

  1. In the CCS 12.6.x Console, navigate to Settings > Deployment View or Grid View.
  2. Right-click on the Application Server and select Configure Log Severity.
  3. From Log Severity, you can select one of the following values:
    1. Warning (This is the default setting) - select Warning to indicate that a potential problem has occurred that may cause serious consequences later if not fixed.
    2. Information - select Information to indicate the normal flow of execution and identify milestone events.
    3. Verbose - select Verbose to indicate the availability of detailed troubleshooting information about events  (Select this option for Verbose Logging)
  4. Click Save. A confirmation message appears that displays the name of the CCS component and the log severity applied. The configured values are set in the service configuration file of the selected CCS component.

NOTE: If you Application server also has a manager installed, also do the followings step:

  1. From Log Level, you can select one of the following values:
    1. Not applicable (This is default for agentless data collection only) – select Not applicable for Agentless data collection.
    2. 0 - Error (This is the default setting for agent based collection) – select 0 - Error to indicate events that cannot be completed because of an error condition.
    3. 1 - Warning – select 1 - Warning to indicate the events that may lead to errors if remediation is not taken.
    4. 2 - Notice – select 2 - Notice to indicate the events need attention but no error condition.
    5. 3 - Information – select 3 - Information to indicate a successful event.
    6. 4 - Data –  select 4 - Data to indicate that it can be used by developers to tag a relevant log statement of an in-memory data structure or a class object member values for more verbose information.
    7. 5 - Debug – select 5 - Debug to indicate the events that include granular information for troubleshooting.
    8. 6 - Trace – select 6 - Trace to indicate the events that include step-by-step progress information of an event, which may be useful for audit and review.   (Select this option for Verbose logging for agent based collection)
  2. Click Save

 

To set Log Severity to Verbose and Log Level on a CCS Manager

  1. In the CCS 12.6.x Console, navigate to Settings > Deployment View or Grid View.
  2. Right-click a CCS Manager and select Configure Log Severity.
  3. From Log Severity, you can select one of the following values:
    1. Warning (This is the default setting) - select Warning to indicate that a potential problem has occurred that may cause serious consequences later if not fixed.
    2. Information - select Information to indicate the normal flow of execution and identify milestone events.
    3. Verbose - select Verbose to indicate the availability of detailed troubleshooting information about events    (Select this option for Verbose logging)
  4. From Log Level, you can select one of the following values:
    1. Not applicable (This is default for agentless data collection only) – select Not applicable for Agentless data collection.
    2. 0 - Error (This is the default setting for agent based collection) – select 0 - Error to indicate events that cannot be completed because of an error condition.
    3. 1 - Warning – select 1 - Warning to indicate the events that may lead to errors if remediation is not taken.
    4. 2 - Notice – select 2 - Notice to indicate the events need attention but no error condition.
    5. 3 - Information – select 3 - Information to indicate a successful event.
    6. 4 - Data –  select 4 - Data to indicate that it can be used by developers to tag a relevant log statement of an in-memory data structure or a class object member values for more verbose information.
    7. 5 - Debug – select 5 - Debug to indicate the events that include granular information for troubleshooting.
    8. 6 - Trace – select 6 - Trace to indicate the events that include step-by-step progress information of an event, which may be useful for audit and review.      (Select this option for Verbose logging for agent based collection)
  5. Click Save.  A confirmation message appears that displays the name of the CCS Manager and the log severity and log level applied. The configured values are set in the C:\Program Files (x86)\Symantec\CCS\Reporting and Analytics\DPS\AgentManagerlogger.conf configuration file of the selected CCS Manager.

 

Collect logs from the Application Server or remote Manager

Once you have set the logging to verbose on your Application server and/or Managers, duplicate the issue you are troubleshooting.  Once you duplicated the issue, collect the logs from the different CCS components by doing the following:

  1. On the CCS 12.6.x Console, navigate to Settings > Deployment View or Grid View.
  2. Right-click a CCS component and select Collect CCS Logs.
  3. Browse and select a directory location on the CCS Console system to save the compressed log files collected from the selected CCS component.
    NOTE: A confirmation message appears that displays the name of the zipped folder that contains the compressed log files and the user-defined directory location in which the compressed log files are downloaded and saved. The compressed logs include logs related to the selected CCS component only.
  4. Attach the saved zip file(s) to the Broadcom support case to be reviewed by CCS Technical support.

 

How to determine what Log Level is currently set on the Application Server and/or CCS Manager, and set logging back to default settings

Once you have duplicate an issue and attached the verbose logs to the case, make sure you set the Logging level on your CCS components back to the default setting to decrease the load that verbose logging creates when enabled.  Follow the steps below to determine what Logging Level is currently enabled on your Application Server and/or CCS Managers:

Refresh the log level of the CCS Components in the Console to make sure the logging level is updated

  1. In the CCS 12.6.x Console, navigate to Settings > Deployment View or Grid View.
  2. In the Infrastructure Tasks dropdown, select Monitor System Jobs.  This will allow you to see the jobs that are currently running.
  3. Also in the Infrastructure Task dropdown, select Sync Configuration, and when that is finished select Refresh Health Status.

To check the log level of the Application Server:

  1. Once the Sync Configuration and Refresh Health Status have finished, right click on the CCS component you would like to see what the logging level is set at, and select Health & Status Details.
  2. On the Application server, in the left hand column select Logging Details under the 'Application Server on <App_server_hostname>' header.  Once that is selected, expand the Application Server Log settings in the right panel.  The Overall Severity will show what severity the Application Server is currently set at (ignore any other settings listed as verbose as that is normal).  Overall Severity set to Warning is the default setting.  If Overall Severity is set to Verbose then verbose logging is enabled, etc.
    NOTE: If your Application Server also has a Manager installed, see the section below on how to determine the logging level on a CCS manager that is installed on the Application Server

To check the log level of a remote CCS Manager

  1. Once the Sync Configuration and Refresh Health Status have finished, right click on the CCS manager you would like to see what the logging level is set at, and select Health & Status Details.
  2. In the left hand column select Logging Details under the 'CCS Manager Service on <hostname>' header.  Once that is selected, expand the CCS Manager Service Log Settings in the right panel.  The Overall Severity will show what severity the CCS Manager is currently set at (ignore any other settings listed as verbose as that is normal).  Overall Severity set to Warning is the default setting.  If the Overall Severity is set to Verbose then verbose logging is enabled, etc.

How to set the logging on the Application Server and/or CCS Managers back to default

  1. In the CCS 12.6.x Console, navigate to Settings > Deployment View or Grid View.
  2. Right click on the CCS Component you would like to set back to default logging and select Configure Log Severity.
  3. Depending if you are using Agentless or Agent-Based collection, do the following:
    1. Agentless collection:
      Log Severity to Warning
      Log Level
      to Not Applicable
    2. Agent-based collection:
      Log Severity to Warning
      Log Level to 0 - Errors
  4. Click Save.

Additional Information

How to manually set verbose logging on CCS v12.5.x Application server and remote managers:

https://knowledge.broadcom.com/external/article?articleId=163985