As part of the Shell Standardization initiative the way the Shell logs are structured has been standardize and a logger that can be used by any Shell was created.

The Networking Shell Standard can be found here.

Definition

Logs Structure

The logs folder is structured as follows:

• reservationId
• <ResourceName>--DD-MM-YYYY--HH-mm-SS.log
• <EnvironmentName>--DD-MM-YYYY--HH-mm-SS.log
• Autoload
• <ResourceName>--DD-MM-YYYY--HH-mm-SS.log

There is a folder per each reservation and its name is equal to the reservation ID. For Autoload commands that are being executed outside of the reservation context there is a separate folder called Autoload.

In those folders there is a file per each resource. The file name is resourceName--D-MMM-YYYY--HH-MM-SS(the time in the file indicates the creation time of the file). In case of environment commands that run as part of an environment orchestration a separate file will be created, this file is namedenvironmentName--D-MMM-YYYY--HH-MM-SS.logand it will include logs both for environment commands (which are part of a driver) and environments scripts.

Each log entry contains the following – date, time, verbosity level, module name (max 50 characters), method name (max 50 characters) and message.

Description of the log record attributes: https://docs.python.org/2/library/logging.html#logrecord-attributes

Logs Configuration

The logger is located in cloudshell-core Python package (link to repository) and comes with a configuration in which it is possible to customize the logs.

To customize the logs verbosity change the LOG_LEVEL from DEBUG to INFO, WARN or ERROR.

It is also possible to customize the structure of a log entry in the LOG_FORMAT section, and the time format used in each log entry in the TIME_FORMAT section.

The location in which the logs will be located is defined in the LOG_PATH.

The default location “../../Logs” translates to the following path in 6.4 Shells:

C:\ProgramData\QualiSystems\QsPython27\Lib\site-pacakges\cloudshell\Logs

Starting from 7.0, the Shells use the python driver infrastructure and the default location “../../Logs” translates to the following path:

C:\ProgramData\QualiSystems\venv\{driverName_version}\Lib\site-packages\cloudshell\Logs

This location refers to a location on each execution server. It is possible to change the path to ashared location that is accessible (including write permissions) to the execution server. To change that just update the LOG_PATH in the qs_config.ini file to‘{sharedLocation}:/Logs/’and restart the execution server.

How to use the standard Logger

Setup the cloudshell-core package:

To use qs_logger install attached cloudshell-core-1.0.11.zip package:

1. Run ‘cmd’ as Administrator
2. cd [Python installation path]\Scripts (in your case it can be C:\ProgramData\QualiSystems\QsPython27\Scripts)
3. run pip install to install the cloudshell-core

Logger example script:

How to use the standard Logger in a Networking Shell

The networking shell that follows the standard has the following python packages structure:

cloudshell-core

--> cloudshell-shell-core

--> cloudshell-networking

--> cloudshell-networking-[vendor]

--> cloudshell-networking-[vendor]-[os]

The logger described in the previous section is located in the “cloudshell-core” and all the definitions required for using it are located in the networking generic resource driver ( cloudshell-networking/cloudshell/networking/resource_driver/networking_generic_resource_dirver.py). Any resource driver that will be based on the networking generic resource driver will get all the logger definitions.

For a resource driver to be based on the networking generic resource driver it should inherit the networking_generic_resource_driver class and use this class’ Init function in the new driver’s Init:

Once the above is defined it is possible to write to the logger in the following format:

Replace “info” with the desired verbosity level (debug, info, warn, error).

from qs_logger import *
def log_something(m_logger, message):
    m_logger.info(message)
    if __name__ == '__main__':
	# test_logger = get_qs_logger('logger_name', 'resource_name', 'reservation_id')
    test_logger = get_qs_logger()
    log_something(test_logger,'>>>My Message<<<')
    test_logger.debug('Sending Command to device')
    test_logger.info('This is Info message')
    test_logger.warning('This is Warning message')
    test_logger.error('This is Critical error message!')
    print 'OK'