8/17/2019 06. WindView

1/29

®6-1

WindView 2.0WindView 2.0

6.1 Introduction

Configuring WindView

Events

8/17/2019 06. WindView

2/29

®6-2

What is WindView?What is WindView?

A software ‘logic anal!er" or ‘run#ti$e anal!er" for our$ultitas%ing a&&lication.

A high &recision gra&hical view of events' tas%s' andinterru&ts in our a&&lication' shown across ti$e.

(el&s diagnose race conditions and ti$ing &ro)le$s.

*ata logging can )e triggered to focus on events ofinterest.

+ther &rogra$s $a access our event log using C,, or

-cl &rogra$$atic interfaces to the event )ase.

WindView for VxSim Lite co$es with -ornado. or othertargets' WindView is an o&tional &roduct.

8/17/2019 06. WindView

3/29

®6-3

(ost/-arget Architecture(ost/-arget Architecture

Eventuffer 

tWvufgr 

tWvufgr 

tWv3&load

tWv3&load

Events

ile

evtecv

evtecv

WindView

4ra&h

-arget(ost

V5Wor%sand

A&&lication

8/17/2019 06. WindView

4/29

®6-4

Configuring WindViewConfiguring WindView

Configuring WindView involves answering severaluestions7

 – When does event logging start and sto&?

 – Which events are logged?

 – (ow is the event )uffer $anaged?

 – When are event data u&loaded to the host?

 – (ow are event data u&loaded to the host?

 – What destination will receive the event data?

8roviding the answers to these uestions $a involve7

 – Configuring V5Wor%s and the target server 

 – 3sing the WindView and -riggering host tools

 – Calling target routines to control logging and u&load

8/17/2019 06. WindView

5/29

®6-5

-arget 9erver ile 9ste$ :-99;-arget 9erver ile 9ste$ :-99;

E5tends the virtual I/+ facilities &rovided ) the targetserver and W* agent7

 – 8rovides re$ote access to host filesste$.

 – -arget server can also o&en -C8 soc%et connections on the host

on )ehalf of target.

oth $ethods are availa)le for event log u&load.

-he user $ust configure the target server to ena)le -99.

 – 9&ecif file sste$ root director.

 – 9&ecif read or read/write access. Write access is reuired for the-99 event log u&load to a file.

-99 co$&onent of the W* agent $ust )e included.

8/17/2019 06. WindView

6/29

®6-6

 ust &rior to the error.

9to& dna$ic )uffer $anage$ent ) defining the$ini$u$ and $a5i$u$ nu$)er of )uffers to )e thesa$e.

8/17/2019 06. WindView

7/29

®6-7

WindView 2.0WindView 2.0

Introduction

6.2 Configuring WindView

Events

8/17/2019 06. WindView

8/29

®6-8

Configuring V5Wor%s for WindViewConfiguring V5Wor%s for WindView

8/17/2019 06. WindView

9/29

®6-9

Which Events are ogged?Which Events are ogged?

-here are three nested classes or levels of events which$a )e )e logged7

 – Conte5t switch events

 – -as% state transition events

 – Additional instru$ented events

Each class includes the &receeding classes.

At the Additional Instrumentation level' one $a selectwhich a$ong several instru$ented V5Wor%s i)rarieswill log events.

8rogra$$aticall' one $a also

 – Instru$ent &articular o)>ects.

 –

og user events with wvEvent().

8/17/2019 06. WindView

10/29

®6-10

WindView Collection ConfigurationWindView Collection Configuration

8/17/2019 06. WindView

11/29

®6-11

3&load 8aths and *estinations3&load 8aths and *estinations

WindView defines several u&load &aths

E5ce&t for the Direct to Graph &ath' one $ust s&ecifadditional infor$ation on the u&load destination7

 – host and &ort nu$)er for soc%et u&load &aths.

 – director and file na$e for file u&load &aths.

8/17/2019 06. WindView

12/29

®6-12

3&load ode3&load ode

*eferred u&load7 – *ata are u&loaded on reuest after logging sto&&ed

 –  ogging also sto&s if event )uffer )eco$es full .

Continuous u&load7

 – *ata are u&loaded &eriodicall as logging continues.

 – ing )uffer grows during ti$es of greater event &roduction'shrin%s once data are u&loaded.

 – ogging sto&s if event )uffer )eco$es full .

8ost $orte$ u&load7

 – *ata are u&loaded on reuest after logging sto&s' often after war$re)oot.

 – Event )uffer is treated as circular. uffers $ust )e in $e$or not

overwritten during the re)oot.

8/17/2019 06. WindView

13/29

®6-13

9etting 3&load 8ath and ode9etting 3&load 8ath and ode

8/17/2019 06. WindView

14/29

®6-14

9tarting and 9to&&ing Collection9tarting and 9to&&ing Collection

9everal $ethods7 –   and )uttons on WindView control &anel.

 – -riggering facilit.

 – 8rogra$$atic control fro$ target.

or soc%et u&load &aths' start evtecvevtecv or o&en listeningWindView gra&h )efore u&loading.

 – or continuous $ode' start the listener )efore starting collection.

or infor$ation a)out &rogra$$atic control' see7

 – wvi) reference &age.

 – usrWindview docu$entation in indView !ser"s Guide.

8/17/2019 06. WindView

15/29

®6-15

-riggering-riggering

Associates actions with WindView events.Action $a )e7

 – 9tart or sto& WindView logging.

 – Call a function.

 – +&tionall' disa)le trigger and/or ena)le another. -rigger fires when ena)led and event $atches criteria7

 – An co$)ination of event t&e' conte5t' and involved sste$o)>ect I*.

 – +&tional conditional e5&ression involving integral glo)al varia)leor I9#safe function of no argu$ent.

3ser trigger events' distinct fro$ user WindView events'$a )e generated using tr#Event().

8/17/2019 06. WindView

16/29

®6-16

-riggering 3ser Interface-riggering 3ser Interface

8/17/2019 06. WindView

17/29

®6-17

WindView 2.0WindView 2.0

Introduction

Configuring WindView

6.@ Events

8/17/2019 06. WindView

18/29

®6-18

*ata Collection is )ased on Events*ata Collection is )ased on Events

What is an Event?...an event is an action underta%en ) a tas% or an I9 that can

affect the state of the real#ti$e sste$.B

 – 9ste$ li)rar instru$entation &oints.

 – 3ser events. E5a$&les7

 – -as% state change.

 – se$4ive se$-a%e.

 – $sgD9end and $sgDeceive.

 – -i$er e5&iration.

 – Anthing ou define as an event.

8/17/2019 06. WindView

19/29

®6-19

3ser#*efined Events3ser#*efined Events

STATUS wvEvent (eventNo, buffer, bufsize)evento I* nu$)er for the event' which will

a&&ear on the viewgra&h.

)uffer address of user su&&lied data.

3 if none.)uf9i!e si!e of user su&&lied data' in )tes.

-he )uffer can contain user data which is &assed u& to

WindView on u&load. -his is dis&laed in a he5#du$&

for$at. 3se this to &rogra$aticall instru$ent events in our

code.

8/17/2019 06. WindView

20/29

®6-20

3ser Event&oints3ser Event&oints

STATUS e (addr, eventNo, taskNameOrId, evtRtn,arg)Where7

addr address to set event&oint.

evento an event nu$)er for dis&la.tas%a$e+rId the tas% I* of the tas% in which to

raise the event&oint' 0 F all tas%s.

evttn function to call when event &oint is

hit. Event is logged if evttn"sreturn value is !ero.

arg an integer argu$ent to &ass to

evttn a)ove.

8/17/2019 06. WindView

21/29

®6-21

WindView E5a$&leWindView E5a$&le

Initiali!ation7Initiali!ation7

Create message queue;

Spawn consumer task;

Spawn producer task;

8roducer -as%78roducer -as%7 Consu$er -as%7Consu$er -as%7FOREVER FOREVER { {

 Allocate block; Wait or message

!pointer to block"

#nitiali$e data in to arri%e on queue;

 block;

&rocess data in

Send pointer to block;

 block across

 message queue; Free block;

'ela( one tick; )

)

8/17/2019 06. WindView

22/29

®6-22

-he ig 8icture-he ig 8icture

Initiali!ation and first few iterations of &roducer #consu$er &rogra$.

8/17/2019 06. WindView

23/29

®6-23

Goo$ing InGoo$ing In

+ne ccle of the &roducer # consu$er &rogra$.

Events are shown in the conte5t in which the occur.

8/17/2019 06. WindView

24/29

®6-24

9earching for Events9earching for Events

ove cursor over event' and descri&tion

a&&ears in status )ar. *ou)le#clic%' and Show Event dialo#  

a&&ears.

8/17/2019 06. WindView

25/29

®6-25

-oo an Events?-oo an Events?

-here are three $eans for filtering the data to reduce thea$ount of infor$ation shown.

 – -he tas% &ou& $enu can )e used to hide an tas%. ight#clic% ontas% na$e on left side of gra&h for a conte5t $enu. -o act on$ulti&le tas%s' select Attri$utes....

 – on#e5ecuting tas% states $a )e hidden ) &ressing thea&&ro&riate )utton on the tool )ar.

 – 9&ecific events and states $a )e filtered out using the ilterEvents/9tatesB dialog.

or hel& re$e$)ering WindView s$)ols' tr7

 – ove $ouse over event' or dou)le#clic% on event.

 – ight#clic% on tas% state sti&&le' select %ontext State

 – ight#clic% and select Le#end  to see event dictionar.

8/17/2019 06. WindView

26/29

®6-26

-as% 9tates and WindView-as% 9tates and WindView

-he &as' State Summar  dis&la gives staticstics a)outthe intervals a tas% s&ends in different states. ight#clic%on the tas% na$e on the left of the gra&h and selectInformation to see this su$$ar.

A running tas% has 3I4 in its state la)el. It $a alsohave either or )oth of +CHE* and I(EI-E*.

 – 8ree$&tion loc%ing and &riorit inheritance are covered in thene5t cha&ter.

A tas% which is not running $a )e in an co$)ination of

the 8E*' *EA

8/17/2019 06. WindView

27/29

®6-27

e$or Events and Analsis 8ac%e$or Events and Analsis 8ac%

8/17/2019 06. WindView

28/29

®6-28

Event ase A8IEvent ase A8I

8rovides C,, and -cl &rogra$$atic interfaces foraccessing and anal!ing event log data in detail.

8rovided as a dna$ic lin% li)rar.

i)rar i$&le$ents o)>ects re&resenting7

 – Event )ase as a whole.

 – -as%' I9' or idle conte5t.

 – Individual event.

 – Cursor for iterating through event )ase.

or $ore infor$ation7

 – A&&endi5 * of indView !ser"s Guide

 – -ornado -ools Wor%sho&

8/17/2019 06. WindView

29/29

®6 29

9u$$ar7 WindView 2.0 vs. 1.09u$$ar7 WindView 2.0 vs. 1.0

-riggering on events now availa)le. ore so&histicated )uffer $anage$ent.

-he -arget 9erver ile 9ste$ and alternative u&load&aths.

3ser can hide irrelevant tas%s.

Analsis &ac%s e5tend analtical &ossi)ilities.

9u$$ar data of tas% states are availa)le on de$and.

Event data are availa)le via -C or C,, A8I for furtheranalsis :the event#)ase A8I;.