Current File : //lib/python2.7/site-packages/salt/utils/win_pdh.pyo
�
���^c @@ s d Z d d l m Z m Z d d l Z d d l Z y" d d l Z d d l Z e Z Wn e
k
ro e Z n Xd d l Z
d d l m Z e j e � Z d Z d � Z d e f d � � YZ d � Z d
� Z d � Z d � Z d d
� Z d � Z d � Z d S( u&
Salt Util for getting system information with the Performance Data Helper (pdh).
Counter information is gathered from current activity or log files.
Usage:
.. code-block:: python
import salt.utils.win_pdh
# Get a list of Counter objects
salt.utils.win_pdh.list_objects()
# Get a list of ``Processor`` instances
salt.utils.win_pdh.list_instances('Processor')
# Get a list of ``Processor`` counters
salt.utils.win_pdh.list_counters('Processor')
# Get the value of a single counter
# \Processor(*)\% Processor Time
salt.utils.win_pdh.get_counter('Processor', '*', '% Processor Time')
# Get the values of multiple counters
counter_list = [('Processor', '*', '% Processor Time'),
('System', None, 'Context Switches/sec'),
('Memory', None, 'Pages/sec'),
('Server Work Queues', '*', 'Queue Length')]
salt.utils.win_pdh.get_counters(counter_list)
# Get all counters for the Processor object
salt.utils.win_pdh.get_all_counters('Processor')
i ( t absolute_importt unicode_literalsN( t CommandExecutionErroru pdhc C@ s0 t j j j � s t d f St s, t d f St S( u8
Only works on Windows systems with the PyWin32
u$ salt.utils.win_pdh: Requires Windowsu, salt.utils.win_pdh: Missing required modules( t saltt utilst platformt
is_windowst Falset HAS_WINDOWS_MODULESt __virtualname__( ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt __virtual__< s
t Counterc B@ s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d Z d Z
d Z d Z d Z d
Z d Z d Z d
Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z! d Z" d � Z# e$ e# � Z# d � Z% d � Z& d � Z' d � Z( d � Z) d � Z* RS( uU
Counter object
Has enumerations and functions for working with counters
i i i i i i i i i i i i i i i i @ i � i i i i i 0i @c C@ sh t j d | | d | | f d � } t j | � d k rO t | | | | | � St d j | � � � d S( u�
Makes a fully resolved counter path. Counter names are formatted like
this:
``\Processor(*)\% Processor Time``
The above breaks down like this:
obj = 'Processor'
instance = '*'
counter = '% Processor Time'
Args:
obj (str):
The top level object
instance (str):
The instance of the object
instance_index (int):
The index of the instance. Can usually be 0
counter (str):
The name of the counter
Returns:
Counter: A Counter object with the path if valid
Raises:
CommandExecutionError: If the path is invalid
i u Invalid counter specified: {0}N( t win32pdht MakeCounterPatht Nonet ValidatePathR R t format( t objt instancet instance_indext countert path( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt
build_counter� s
! c C@ sL | | _ | | _ | | _ | | _ | | _ d | _ d | _ d | _ d S( N( R R R t indexR R t handlet infot type( t selfR R R R R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt __init__� s c C@ s t j | | j � | _ d S( u�
Add the current path to the query
Args:
query (obj):
The handle to the query to add the counter
N( R t
AddCounterR R ( R t query( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt add_to_query� s c C@ s� | j s� t j | j d � } i | d d 6| d d 6| d d 6| d d 6| d d
6| d d 6| d
d 6| d d d 6| d d d 6| d d d 6| d d d 6| d d d 6| d d d 6| d d 6| _ n | j S( u�
Get information about the counter
.. note::
GetCounterInfo sometimes crashes in the wrapper code. Fewer crashes
if this is called after sampling data.
i u typei u versioni u scalei u
default_scalei u user_datai u query_user_datai u full_pathi u machine_nameu object_nameu
instance_nameu parent_instanceu instance_indexu counter_namei u explain_text( R R t GetCounterInfoR ( R t ci( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt get_info� s$ c C@ s+ t j | j t j � \ } } | | _ | S( u`
Return the counter value
Returns:
long: The counter value
( R t GetFormattedCounterValueR t PDH_FMT_DOUBLER ( R t counter_typet value( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyR& � s c C@ sv | j � d } g } xY t | � D]K } | j d � r# t | | � } | rn | | @rn | j | d � qn q# q# W| S( u~
Returns the names of the flags that are set in the Type field
It can be used to format the counter.
u typeu PERF_i ( R" t dirt
startswitht getattrt append( R R t type_listt membert bit( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt type_string� s c C@ s | j S( N( R ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt __str__� s (+ t __name__t
__module__t __doc__t PERF_SIZE_DWORDt PERF_SIZE_LARGEt PERF_SIZE_ZEROt PERF_SIZE_VARIABLE_LENt PERF_TYPE_NUMBERt PERF_TYPE_COUNTERt PERF_TYPE_TEXTt PERF_TYPE_ZEROt PERF_NUMBER_HEXt PERF_NUMBER_DECIMALt PERF_NUMBER_DEC_1000t PERF_COUNTER_VALUEt PERF_COUNTER_RATEt PERF_COUNTER_FRACTIONt PERF_COUNTER_BASEt PERF_COUNTER_ELAPSEDt PERF_COUNTER_QUEUE_LENt PERF_COUNTER_HISTOGRAMt PERF_TEXT_UNICODEt PERF_TEXT_ASCIIt PERF_TIMER_TICKt PERF_TIMER_100NSt PERF_OBJECT_TIMERt PERF_DELTA_COUNTERt PERF_DELTA_BASEt PERF_INVERSE_COUNTERt PERF_MULTI_COUNTERt PERF_DISPLAY_NO_SUFFIXt PERF_DISPLAY_PER_SECt PERF_DISPLAY_PERCENTt PERF_DISPLAY_SECONDSt PERF_DISPLAY_NO_SHOWR t staticmethodR R R" R& R. R/ ( ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyR I sR '
c C@ s t t j d d d d � � S( uu
Get a list of available counter objects on the system
Returns:
list: A list of counter objects
i����i N( t sortedR t EnumObjectsR ( ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt list_objects� s c C@ s t j d d | d d � d S( u#
Get a list of counters available for the object
Args:
obj (str):
The name of the counter object. You can get a list of valid names
using the ``list_objects`` function
Returns:
list: A list of counters available to the passed object
i����i N( R t EnumObjectItemsR ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt
list_counters s c C@ s t j d d | d d � d S( u%
Get a list of instances available for the object
Args:
obj (str):
The name of the counter object. You can get a list of valid names
using the ``list_objects`` function
Returns:
list: A list of instances available to the passed object
i����i i N( R RW R ( R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt list_instances s c C@ s� g } d } xs | D]k \ } } } y3 t j | | | | � } | d 7} | j | � Wq t k
r} } t j | j � q q Xq W| S( u�
Create a list of Counter objects to be used in the pdh query
Args:
counter_list (list):
A list of tuples containing counter information. Each tuple should
contain the object, instance, and counter name. For example, to
get the ``% Processor Time`` counter for all Processors on the
system (``\Processor(*)\% Processor Time``) you would pass a tuple
like this:
```
counter_list = [('Processor', '*', '% Processor Time')]
```
If there is no ``instance`` for the counter, pass ``None``
Multiple counters can be passed like so:
```
counter_list = [('Processor', '*', '% Processor Time'),
('System', None, 'Context Switches/sec')]
```
.. note::
Invalid counters are ignored
Returns:
list: A list of Counter objects
i i ( R R R* R t logt debugt strerror( t counter_listt countersR R R t counter_nameR t exc( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt build_counter_list$ s
c C@ s� t j d d | d d � \ } } | d k r6 | } n t | t � sQ | g } n g } xi | D]a } xX | D]: } | j � d k r� d n | } | j | | | f � qk W| j | d | f � q^ W| r� t | � Si S( u�
Get the values for all counters available to a Counter object
Args:
obj (str):
The name of the counter object. You can get a list of valid names
using the ``list_objects`` function
instance_list (list):
A list of instances to return. Use this to narrow down the counters
that are returned.
.. note::
``_Total`` is returned as ``*``
i����i u _totalu *N( R RW R t
isinstancet listt lowerR* t get_counters( R t
instance_listR^ t instances_availR] R R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt get_all_countersQ s !
c C@ s� t | t � s t d � � n z� t j � } t | � } x | D] } | j | � q@ Wt j | � t j d � t j | � i } x` | D]X } y! | j
i | j � | j 6� Wq� t
j k
r� } | j d k r� q� q� � q� Xq� WWd t j | � X| S( u�
Get the values for the passes list of counters
Args:
counter_list (list):
A list of counters to lookup
Returns:
dict: A dictionary of counters and their values
u% counter_list must be a list of tuplesi u No data to return.N( Rb Rc R R t OpenQueryRa R t CollectQueryDatat timet sleept updateR& R t
pywintypest errorR\ t
CloseQuery( R] R R^ R t retR` ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyRe u s(
!c C@ s t | | | f g � S( u,
Get the value of a single counter
Args:
obj (str):
The name of the counter object. You can get a list of valid names
using the ``list_objects`` function
instance (str):
The counter instance you wish to return. Get a list of instances
using the ``list_instances`` function
.. note::
``_Total`` is returned as ``*``
counter (str):
The name of the counter. Get a list of counters using the
``list_counters`` function
( Re ( R R R ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt get_counter� s ( R2 t
__future__R R t loggingRk Rn R t TrueR t ImportErrorR t salt.utils.platformR t salt.exceptionsR t getLoggert __file__RZ R R
t objectR RV RX RY Ra R Rh Re Rr ( ( ( s6 /usr/lib/python2.7/site-packages/salt/utils/win_pdh.pyt <module>" s,
�
- $ 2
Mini Shell