iogR SrSSKrSSKrSSKrSSKrSSKJr SSKJrJ r J r J r J r SSK Jr SSKJrJrJrJrJr SSKJrJrJrJr \"\"S55r\\R4l\\\\/\R4l\\R:l\\\\\/\R:l\\R<l\\\"\5\"\5/\R<l\\R>l\\\"\5\"\5/\R>l\\R@l\\\\\"\5\"\5\"\5/\R@l\\RBl\\/\RBl\\RDl\\/\RDl\\RFl\"\"\ 55\/\RFl\\RHl\"\ 5\/\RHl\\RJl\"\"\ 55\/\RJl\\RLl/\RLlS r#S r$S r%S r&"S S\5r'"SS\5r("SS\5r)"SS\ 5r*"SS\+5r,"SS\,5r-g)aWrapper module for libpcp_pmda - Performace Co-Pilot Domain Agent API # # Copyright (C) 2013-2015,2017-2021 Red Hat. # # This file is part of the "pcp" module, the python interfaces for the # Performance Co-Pilot toolkit. # # This program is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by the # Free Software Foundation; either version 2 of the License, or (at your # option) any later version. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License # for more details. # # See pmdasimple.py for an example use of this module. N) pmContext)pmInDompmDescpmUnitspmErr pmLabelSet) find_library)CDLLc_intc_longc_char_pc_void_p) addressofbyrefPOINTER Structurepcp_pmdac[[5"5n[R[ U5U5nUS:a [ U5eU$Nr)rr LIBPCP_PMDA pmdaAddLabelsrrlabelresult_pstatuss */usr/lib/python3/dist-packages/pcp/pmda.pyrrHs;z"$H  & &uX >F zFm OcR[RX5nUS:a [U5eU$r)rpmdaAddLabelFlagsr)labelsflagsrs rrrOs(  * *6 9F zFm Mrc[[5"5n[R[ U5U5nUS:a [ U5eU$r)rrr pmdaAddNotesrrrs rr#r#Us;z"$H  % %eHou =F zFm OrcP[R5nUS:a [U5eU$r)rpmdaGetContextr)rs rr%r%\s&  ' ' )F zFm Mrc4\rSrSrSrS\4S\4/rSrSr Sr g) pmdaMetricfz4Structure describing a metric definition for a PMDA m_userm_descc[R"U5 SUlXRlX RlX0RlX@RlXPRlgN) r__init__r)r*pmidtypeindomsemunits)selfr.typeofr0r1r2s rr-pmdaMetric.__init__ksH4   ! !  ! rctS[U5URRURR4-$)Nz!pmdaMetric@%#lx pmid=%#lx type=%d)rr*r.r/r3s r__str__pmdaMetric.__str__ts/2iot{{GWGWY]YdYdYiYi5jjjr)r)N) __name__ __module__ __qualname____firstlineno____doc__rr_fields_r-r8__static_attributes__rrr'r'fs'?8$6"$H"krr'c4\rSrSrSrS\4S\4/rSrSr Sr g) pmdaInstidwz5Structure describing an instance (index/name) a PMDA i_insti_namech[R"U5 XlURS5Ulg)Nutf-8)rr-rEencoderF)r3instidnames rr-pmdaInstid.__init__|s%4  kk'* rcLS[U5URUR4-$)Nz pmdaInstid@%#lx index=%d name=%s)rrErFr7s rr8pmdaInstid.__str__s#1Yt_dkkSWS^S^4___r)rErFN) r:r;r<r=r>r r r?r-r8r@rArrrCrCws'@5!8$&H+ `rrCc\rSrSrSrS\4S\4S\"\54/r Sr Sr Sr S r S rS rS rS rSrSrSrSrSrSrg) pmdaIndomz6Structure describing an instance domain within a PMDA it_indom it_numinstit_setc[R"U5 SUlSUlXlUR X5 UR X5 gr)rr-rSrTrR load_indom set_instancesr3r0instss rr-pmdaIndom.__init__s=4    % 5(rc## URS::a[RUR[R 5 [RUR[R 5nUS:agURU5nU(aX4v MT[UR5H;nURURnURU5nU(dM6X4v M= g7fr) rSr pmdaCacheOprRcpmdaPMDA_CACHE_WALK_REWINDPMDA_CACHE_WALK_NEXTinst_name_lookuprangerTrE)r3instrKis r__iter__pmdaIndom.__iter__s ??a   # #DMM$)$@$@ B"..t}}/4/I/IK!8,,T2,&4??+{{1~,,,,T24,& ,s CC+! C+cURS::an[5n[RURU[ U5S5nU[ R:Xa#[URR55$gURS:aHURH8nURU:XdM[URR55s $ gr)rSr rpmdaCacheLookuprRrr]PMDA_CACHE_ACTIVEstrvaluedecoderTrErF)r3instancerKstsrbs rr`pmdaIndom.inst_name_lookups ??a rr rrCr?r-rdr`rVrvr}rrWr8rrrrr@rArrrPrPsmAW%u%7:./1H)'( BJ!+f++ + +rrPc\rSrSrSrSrSrg) pmdaUnitszEWrapper class for PMDAs defining their metrics (avoids pmapi import) c 6[R"XX#XEU5 gr,)rr-)r3dimSdimTdimCscaleSscaleTscaleCs rr-pmdaUnits.__init__sTHrrAN)r:r;r<r=r>r-r@rArrrrs PIrrcn\rSrSrSrSrSrSrSrSr Sr SS jr S r SS jr S rS rSrSrSrg)MetricDispatchaHelper for PMDA class which manages metric dispatch table, metric namespace, descriptors and help text. Overall strategy is to interface to the C code in python/pmda.c here, using a void* handle to the PMDA dispatch structure (allocated and managed in C code). In addition, several dictionaries for metric related strings are managed here (names, help text) - cached for quick lookups in callback routines. c/Ul0Ul0Ul0Ul/Ul0Ul0Ul0Ul0Ul0Ul [R"XX45 gr,) _indomtable_indoms_indom_oneline_indom_helptext _metrictable_metrics _metric_names_metric_names_map_metric_oneline_metric_helptextr] init_dispatch)r3domainrKlogfilehelpfiles rr-MetricDispatch.__init__s`  ! !#! " F'[ UR 5H%upVURU:XdMX@R U' O X@R U'gr,)rprPrRlist enumeraterr)r3r0rYrR replacementrcrs r replace_indomMetricDispatch.replace_indomqs} eY ' '~~HKH#H4K eT " "%d&6&67>>X-*5$$Q'8"- XrcURUnURS:a@[5n[R XS[ U55nU[ R:XaU$g)z Lookup the value associated with an (internal) instance ID within a specific instance domain (only valid with indoms of cache type - array indom will always return None). rN)rrSrrrgrr]rh)r3r0rlrrjrms r inst_lookupMetricDispatch.inst_lookupsU  U#   a LE--etU5\RCe--- rcBURUnURU5$)z^ Lookup the name associated with an (internal) instance ID within a specific instance domain. )rr`)r3r0rlrs rr`MetricDispatch.inst_name_lookups#  U#%%h//rctUR[R"X5nU$![a SnU$f=f)zB Lookup the name associated with a performance metric identifier. N)rr] pmda_pmidr)r3clusteritemrKs rpmid_name_lookupMetricDispatch.pmid_name_lookupsB %%eoog&DED  D  s #' 77) rrrrrrrrrrN)r)r:r;r<r=r>r-rrrrrrrrrrr`rr@rArrrrsH  =%*&!/ ! !--$ 0rrc\rSrSrSrSrSr\"\SSS5r\"\SSS5r S(Sjr Sr Sr S r S rS rS r\S 5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r\S5r \S5r!\S5r"\S5r#\S5r$\S 5r%\S!5r&\S"5r'\S#5r(\S$5r)\S%5r*\S&5r+S'r,g))PMDAiz]Defines a PCP performance metrics domain agent Used to add new metrics into the PCP toolkit. cUR$)zProperty for name of this PMDA )_namer7s r read_namePMDA.read_names zzrcUR$)z/Property for unique domain number of this PMDA )_domainr7s r read_domainPMDA.read_domains ||rNcXlX lU(dUS-nSU-nU(d[R"S5<SU<S3n[R XXSU5 g)Nz.logpmda PCP_PMDAS_DIR/z/help)rrPCP pmGetConfigrr-)r3rKrrrpmdanames rr- PMDA.__init__sI  VmGD='*'GNHhJrcg)z Probe the domain to see if the PMDA could be activated Used by pmcheck(1) - see man page for meaning of (int) return codes - as part of PMDA specific scripts. crAr7s r domain_probePMDA.domain_probes rch[SURR5UR4-5 g)z8 Write out the domain.h file (used during installation) z #define %s %dN)printrupperrr7s r domain_writePMDA.domain_writes' o!1!1!3T\\ BBCrcURnUVs1sHo2URS5SiM nnUS:HnSnU(a Sn[S5 UHn[SXgUR4-5 M U(a [S5 g g s snf) z9 Write out the namespace file (used during installation) .rrootr zroot {z %s%s %d:*:*}N)rsplitrr)r3r pmnsrprefixesindentleadprefixs r pmns_writePMDA.pmns_writes!!7;  ' '(;(; <  ( ()=)= >    0 0$2C2C Drc.[R"U5$r,)r] set_fetch)fetchs rr0PMDA.set_fetchu%%rc.[R"U5$r,)r] set_label)rs rr5PMDA.set_labelr3rc.[R"U5$r,)r] set_notes)notess rr8PMDA.set_notesr3rc.[R"U5$r,)r] set_refresh)refreshs rr<PMDA.set_refreshs  ))rc.[R"U5$r,)r] set_instance)rls rr@PMDA.set_instance s!!(++rc.[R"U5$r,)r]set_fetch_callback)fetch_callbacks rrCPMDA.set_fetch_callback$''77rc.[R"U5$r,)r]set_label_callback)label_callbacks rrHPMDA.set_label_callback(rFrc.[R"U5$r,)r]set_notes_callback)notes_callbacks rrLPMDA.set_notes_callback,rFrc.[R"U5$r,)r]set_attribute_callback)attribute_callbacks rrPPMDA.set_attribute_callback0s++,>??rc.[R"U5$r,)r]set_store_callback)store_callbacks rrTPMDA.set_store_callback4rFrc.[R"U5$r,)r]set_endcontext_callback)endcontext_callbacks rrXPMDA.set_endcontext_callback8s,,-@AArc.[R"U5$r,)r]set_refresh_all) refresh_alls rr\PMDA.set_refresh_all<s$$[11rc.[R"U5$r,)r]set_refresh_metrics)refresh_metricss rr`PMDA.set_refresh_metrics@s((99rc.[R"5 gr,)r]set_notify_changerArrrdPMDA.set_notify_changeDs !rcvS[R;a[R$[R"U5$)Nr)r"r#rPM_ERR_NOTCONNpmSetProcessIdentity)usernames rset_user PMDA.set_userHs+  +(( (**844rc.[R"X5$r,)r]r)rrs rr. PMDA.pmidNsw--rc0[R"XU5$r,)r] pmid_build)rrrs rroPMDA.pmid_buildRs66rc.[R"U5$r,)r] pmid_cluster)rs rrrPMDA.pmid_clusterVs!!'**rc.[R"U5$r,)r] pmda_indom)serials rr0 PMDA.indomZs''rc.[R"X5$r,)r] indom_build)rrvs rryPMDA.indom_build^s  00rc2[R"XX#XE5$r,)r] pmda_units) dim_spacedim_time dim_count scale_space scale_time scale_counts rr2 PMDA.unitsbs YZeerc.[R"U5$r,)r] pmda_uptime)nows ruptime PMDA.uptimefs  %%rc.[R"U5$r,)r]pmda_set_comm_flags)r!s rset_comm_flagsPMDA.set_comm_flagsjs((//rc.[R"U5$r,)r]pmda_logmessages rlogPMDA.logn~~g&&rc.[R"U5$r,)r]pmda_dbgrs rdbgPMDA.dbgrrrc.[R"U5$r,)r]pmda_errrs rerrPMDA.errvrr)rr)NN)-r:r;r<r=r>rrpropertyrKrr-rrrrrr- staticmethodr0r5r8r<r@rCrHrLrPrTrXr\r`rdrjr.rorrr0ryr2rrrrrr@rArrrrsg ItT4 0D k4t 4F KD    E4&&&&&&**,,888888@@88BB22::""55 ..77++((11ff&&00''''''rr).r>r"r%rr] pcp.pmapirrrrrrr ctypes.utilr ctypesr r r r rrrrrrrrestypeargtypespmdaCacheStoreKeyrgpmdaCacheLookupNamepmdaCacheLookupKeyr\rrrr#r%r'rCrProbjectrrrArrrst, &AA$::77< +, &+ "'.x&J #(- %%*3 &&+ #)78+<(> $*/ '75>78+<,> (). &5(GH,=)++ '#( $+V#4  &+ #(/'7 $$) !&-gj.A&BH%M "(- %*1**=u)E &#(  %,WZ-@%A8$L !%* "&( # kk" ` `p+ p+dIIaVaHT'>T'r