wlauto.instrumentation.streamline package

Module contents

class wlauto.instrumentation.streamline.StreamlineInstrument(device, **kwargs)

Bases: wlauto.core.instrumentation.Instrument

aliases = AC([])

artifacts = AC([])

configuration_file_name = 'configuration.xml'

core_modules = []

daemon = 'gatord'

description = '\n Collect Streamline traces from the device.\n\n .. note:: This instrument supports streamline that comes with DS-5 5.17 and later\n earlier versions of streamline may not work correctly (or at all).\n\n This Instrument allows collecting streamline traces (such as PMU counter values) from\n the device. It assumes you have DS-5 (which Streamline is part of) installed on your\n system, and that streamline command is somewhere in PATH.\n\n Streamline works by connecting to gator service on the device. gator comes in two parts\n a driver (gator.ko) and daemon (gatord). The driver needs to be compiled against your\n kernel and both driver and daemon need to be compatible with your version of Streamline.\n The best way to ensure compatibility is to build them from source which came with your\n DS-5. gator source can be found in ::\n\n /usr/local/DS-5/arm/gator\n\n (the exact path may vary depending of where you have installed DS-5.) Please refer to the\n README the accompanies the source for instructions on how to build it.\n\n Once you have built the driver and the daemon, place the binaries into your\n ~/.workload_automation/streamline/ directory (if you haven\'t tried running WA with\n this instrument before, the streamline/ subdirectory might not exist, in which\n case you will need to create it.\n\n In order to specify which events should be captured, you need to provide a\n configuration.xml for the gator. The easiest way to obtain this file is to export it\n from event configuration dialog in DS-5 streamline GUI. The file should be called\n "configuration.xml" and it be placed in the same directory as the gator binaries.\n '

driver = 'gator.ko'

finalize(*args, **kwargs)

initialize(*args, **kwargs)

kind = 'instrument'

name = 'streamline'

parameters = AC(["Param({'kind': <type 'list'>, 'mandatory': None, 'name': 'modules', 'constraint': None, 'default': None, 'allowed_values': None, 'global_alias': None, 'override': False})", "Param({'kind': <type 'str'>, 'mandatory': None, 'name': 'port', 'constraint': None, 'default': '8080', 'allowed_values': None, 'global_alias': None, 'override': False})", "Param({'kind': <type 'str'>, 'mandatory': None, 'name': 'configxml', 'constraint': None, 'default': None, 'allowed_values': None, 'global_alias': None, 'override': False})", "Param({'kind': <function boolean>, 'mandatory': None, 'name': 'report', 'constraint': None, 'default': False, 'allowed_values': None, 'global_alias': 'streamline_report_csv', 'override': False})", "Param({'kind': <type 'str'>, 'mandatory': None, 'name': 'report_options', 'constraint': None, 'default': '-format csv', 'allowed_values': None, 'global_alias': None, 'override': False})"])

setup(context)

start(context)

stop(context)

teardown(context)

update_result(context)

validate(*args, **kwargs)

class wlauto.instrumentation.streamline.StreamlineResourceGetter(resolver, **kwargs)

Bases: wlauto.core.resource.ResourceGetter

aliases = AC([])

artifacts = AC([])

core_modules = []

dependencies_directory = '/home/docs/.workload_automation/dependencies/streamline'

finalize(*args, **kwargs)

get(resource, **kwargs)

initialize(*args, **kwargs)

kind = 'resource_getter'

name = 'streamline_resource'

old_dependencies_directory = '/home/docs/.workload_automation/streamline'

parameters = AC(["Param({'kind': <type 'list'>, 'mandatory': None, 'name': 'modules', 'constraint': None, 'default': None, 'allowed_values': None, 'global_alias': None, 'override': False})"])

priority = 1

resource_type = 'file'

validate(*args, **kwargs)