Re: about instrumentation client.

2003-01-21 Thread Marcus Crafter
Hi Antonio!

On Mon, Jan 20, 2003 at 06:10:13PM -0600, Antonio Gallardo wrote:
 Hi Marcus!
 
 Thanks again!

No problem :)

 I am back for some advise from the instruments guru. ;-)
 
 Where I can find some explaination about the aditional info in the
 instrument manager?
 
 For example the authentication manager has:
 
 authentication-manager
   pool  - The pool of the manager
 blocks  - ?
 creates - Create() a component in the pool
 decommissions   - Destroy() components in the pool
 gets- Already created and getted?
 puts- Already in the pool and returned?
 ready-size  - ?
 size- ? in KB or number of components?
   gets  - ?
   puts  - ?
   references- Sum of the calls to
 manager.lock(auth-manager.ROLE) in the code.
 
 I know that the components must be declared as instrumentable. But I
 think currently there are no many components declared as needed.

Yes, you're right. Components wishing to report instrumentation
data to the client need to implement the Avalon 'instrumentable'
interface, which allows the them to define instruments that can
be sampled from.

At the moment there aren't many components (none in Cocoon) that 
support instrumentation except for ECM, Instrument Manager, and the 
Avalon datasource, and pool subprojects.

What you are seeing above is reporting from instruments that are
registered automatically from the above list of projects (ie.
ECM's component handlers, which for example use pool for Poolable 
components, etc). 

Here's a brief breakdown of what you listed above:

authentication-manager  - The authentication manager component handler (not
  the component itself).
  pool  - The pool used within the authentication
  manager's component handler
blocks  - threads blocking till a poolable becomes available
creates - Create() a component in the pool
decommissions   - Destroy() components in the pool
gets- Poolables accessed
puts- Poolables returned
ready-size  - number of pooolables currently available
size- total number of poolables this pool has
  gets  - number of gets (ie. lookups) of this component
  puts  - number of puts (ie. releases) of this component
  references- number of references to this component

Hope that makes things a bit clearer, unfortunately this isn't yet
documented anywhere, I obtained the above info from browsing the
Avalon source for the ComponentHandler and ResourceLimitingPool
classes.

The job now (apart from docs) is to write a more wider set of 
instruments to report Cocoon specific data. I've made a start to
this, but there's still a ways to go.

Hope that helps.

Cheers,

Marcus

-- 
.
 ,,$,  Marcus Crafter
;$'  ':Computer Systems Engineer
$: :   ManageSoft GmbH
 $   o_)$$$:   82-84 Mainzer Landstrasse
 ;$,_/\ :'   60327 Frankfurt Germany
   ' /( 
   \_'
  .
:

-
Please check that your question  has not already been answered in the
FAQ before posting. http://xml.apache.org/cocoon/faq/index.html

To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail:   [EMAIL PROTECTED]




about instrumentation client.

2003-01-20 Thread Antonio Gallardo
Hi Marcus!

Thanks again!

I am back for some advise from the instruments guru. ;-)

Where I can find some explaination about the aditional info in the
instrument manager?

For example the authentication manager has:

authentication-manager
  pool  - The pool of the manager
blocks  - ?
creates - Create() a component in the pool
decommissions   - Destroy() components in the pool
gets- Already created and getted?
puts- Already in the pool and returned?
ready-size  - ?
size- ? in KB or number of components?
  gets  - ?
  puts  - ?
  references- Sum of the calls to
manager.lock(auth-manager.ROLE) in the code.

I know that the components must be declared as instrumentable. But I
think currently there are no many components declared as needed.

Best Regards,

Antonio Gallardo






-
Please check that your question  has not already been answered in the
FAQ before posting. http://xml.apache.org/cocoon/faq/index.html

To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail:   [EMAIL PROTECTED]