Index

_pmID_int structure
Data Structures

_pmInDom_int structure
Data Structures

access controls
Configuring the Trace PMDA

acronyms
Acronyms

ancillary support services
PMAPI Ancillary Support Services

Application Programming Interface
PMAPI--The Performance Metrics API
Application Interaction
Trace API

application programs
Application and Agent Development

applications
compiling
Compiling and Linking PMAPI Applications
instrumentation
Instrumenting Applications to Export Performance Data
interaction
Application Interaction

architecture
PCP Architecture
PMDA Architecture

archive logs
context services
PMAPI Context Services
performance data
PMAPI--The Performance Metrics API
Current PMAPI Context
performance management
Instrumenting Applications to Export Performance Data
pmGetArchiveEnd function
pmGetArchiveEnd Function
pmGetInDomArchive function
pmGetInDomArchive Function
retrospective sources
Retrospective Sources of Performance Metrics
time control services
PMAPI Time Control Services

archive-specific services
pmGetArchiveLabel Function

Array PMDA
Distributed Collection

arrays
instance description
Data Structures
N dimensional data
N Dimensional Data
performance metrics
Performance Metrics Values
Variable Length Argument and Results Lists

asynchronous trace protocol
Configuring the Trace Library
Configuring the Trace Library

audience
Programming Performance Co-Pilot

automated alarms
Instrumenting Applications to Export Performance Data

caching PMDA
Caching PMDA
Latency and Threads of Control

chkhelp tool
Application and Agent Development

Cisco PMDA
Distributed Collection
Caching PMDA

client development
Client Development and PMAPI

clusters
Name Space

collection time
Current PMAPI Context
pmNewContext Function
pmWhichContext Function

collection tools
PCP Architecture

collector hosts
Distributed Collection

COLOR_INDOM
Data Structures

compiling and linking
Compiling and Linking PMAPI Applications

component software
Overview of Component Software

computation state
Instrumenting Applications to Export Performance Data

configuration
Configuring the Trace Library
Configuring PCP Tools

context services
PMAPI Context Services

control threads
Latency and Threads of Control

counter semantics
Semantics

customers
Instrumenting Applications to Export Performance Data

customization
Programming Performance Co-Pilot
Instrumenting Applications to Export Performance Data

daemon process method
Daemon Process Method

data export
Instrumenting Applications to Export Performance Data

data structures
Data Structures
Data Structures

dbpmda man page
Implementing a PMDA
Overview
dbpmda Debug Utility

dbx man page
Overview

debugging and testing
Testing and Debugging a PMDA
Configuring the Trace Library

debugging flags
See flags

delays
Latency and Threads of Control

design requirements
Implementing a PMDA

diagnostic output
Configuring the Trace Library

dimensionality and scale
Performance Metric Descriptions

discrete semantics
Semantics

distributed performance management
data transportation
Instrumenting Applications to Export Performance Data
metrics collection
Distributed Collection

dlopen man page
In-Process (DSO) Method
DSO PMDA

DNS
Acronyms

domains
definition
Overview
fields
Name Space
numbers
Domains

dometric function
pmTraversePMNS Function

DSO
Acronyms
architecture
PMDA Architecture
disadvantages
Daemon PMDA
implementation
DSO PMDA
interface
DSO Interface
PMDA building
In-Process (DSO) Method
PMDA initialization
Common Initialization

dynamic shared object
See DSO

embedded calls
Instrumenting Applications to Export Performance Data

environment variables
Configuring the Trace Library
Instrumenting Applications to Export Performance Data

error handling
Handling PMAPI Errors

examples
alarm tools
Implementing a PMDA
Install script
Installing a PMDA
programming issues
PMAPI Programming Issues and Examples
Remove script
Removing a PMDA
rolling-window sampling
Rolling-Window Periodic Sampling Example
simple and trivial PMDAs
Domains, Metrics, and Instances
time control functions
PMAPI Time Control Services
trace PMDA
Trace PMDA
visualization tools
Implementing a PMDA

execv system call
Daemon PMDA

exporting data
Extracting the Information

flags
debugging
Debugging Information
state
Configuring the Trace Library

fork system call
Daemon PMDA

glossary
Acronyms

handle context
pmReconnectContext Function

help text
creation
Installing a PMDA
initialization
Common Initialization
location
Installing a PMDA
PDU_TEXT_REQ
Overview
pmLookupInDomText function
pmLookupInDomText Function
pmLookupText function
Management of Evolution within a PMDA
pmLookupText Function
structure specification
Implementing a PMDA
terse and extended descriptions
PMDA Help Text

historical buffers
Simple Periodic Sampling
Rolling-Window Periodic Sampling
Configuring the Trace PMDA

identification tags
Application Interaction

implementation
Implementing a PMDA

independent software vendors
Instrumenting Applications to Export Performance Data

indom instance domain
pmLookupInDomText Function
pmAddProfile Function
pmGetInDomArchive Function

information extraction
Extracting the Information

initialization
Initializing New Metrics

instance domain refresh
Configuring the Trace PMDA

instance domain services
pmGetInDom Function

instantaneous semantics
Semantics

instlist argument
pmGetInDom Function
pmAddProfile Function

instrumentation
Performance Instrumentation and Tracing
Instrumenting Applications to Export Performance Data

integrating a PMDA
Integration of PMDA

internal instance identifier
Performance Metrics Values

interpolated metrics
pmSetMode Function

interprocess communication
See IPC
PMTRACE_STATE_NOAGENT flag
Configuring the Trace Library

IPC
DSO
In-Process (DSO) Method
PMDA
Implementing a PMDA
trace API
Application Interaction

item numbers
Name Space

iterative processing
Iterative Processing of Values

languages
Instrumenting Applications to Export Performance Data

latency
Latency and Threads of Control

leaf node
pmTraversePMNS Function

libpcp_trace library
Application Programming Interface
Trace API
entry points
Configuring the Trace Library
functions
Configuring the Trace Library
instrumenting applications
Trace PMDA

library reentrancy
Library Reentrancy and Threaded Applications

metric description services
pmLookupDesc Function

metrics
API
Naming and Identifying Performance Metrics
definition
Overview
Metrics
name and value
Symbolic Association between a Metric's Name and Value

metrics and instances
Overview

metrics description services
pmLookupDesc Function

metrics services
pmFetch Function

monitoring tools
PCP Architecture

multidimensional arrays
N Dimensional Data

multiple threads
Library Reentrancy and Threaded Applications

name space
Name Space
Name Space

new metrics
Management of Evolution within a PMDA
Initializing New Metrics

new PMDA
Upgrading a PMNS to Include Metrics from a New PMDA

newhelp man page
PMDA Help Text

newhelp tool
Application and Agent Development

NOW_INDOM
Data Structures

observation metric units
Configuring the Trace PMDA

parallelism
Instrumenting Applications to Export Performance Data

PCP
acronym
Acronyms
description
Programming Performance Co-Pilot
tool summaries
Application and Agent Development

PCP_TRACE_HOST variable
Configuring the Trace Library

PCP_TRACE_PORT variable
Configuring the Trace Library

PCP_TRACE_RECONNECT variable
Configuring the Trace Library

PCP_TRACE_REQTIMEOUT variable
Configuring the Trace Library

PCP_TRACE_TIMEOUT variable
Configuring the Trace Library

PDU
Overview
Application Interaction
Configuring the Trace Library
Acronyms

PDU_DESC_REQ
Overview

PDU_FETCH
Overview
Simple PMDA

PDU_INSTANCE_REQ
Overview

PDU_PROFILE
Overview

PDU_RESULT
Overview
Simple PMDA

PDU_TEXT_REQ
Overview

performance instrumentation
Programming Performance Co-Pilot
Performance Instrumentation and Tracing

Performance Metric Identifier
See PMID

performance metrics
See metrics

Performance Metrics Application Programming Interface
See PMAPI

Performance Metrics Collection Daemon
See PMCD

Performance Metrics Collection Subsystem
Client Development and PMAPI
See Also PMCS

Performance Metrics Domain Agent
See PMDA

Performance Metrics Name Space
See PMNS

periodic sampling
Simple Periodic Sampling

pipe
Daemon PMDA
Daemon PMDA

PM_CONTEXT_ARCHIVE type
pmNewContext Function

PM_CONTEXT_HOST type
pmNewContext Function

PM_ERR_CONV error code
Management of Evolution within a PMDA
pmExtractValue Function

PM_ERR_INST error code
simple_store in the Simple PMDA

PM_ERR_PMID error code
Management of Evolution within a PMDA
simple_store in the Simple PMDA

PM_ERR_SIGN error code
pmExtractValue Function

PM_ERR_TIMEOUT error code
pmFetch Function

PM_ERR_TRUNC error code
pmExtractValue Function

PM_IN_NULL instance identifier
Performance Metric Instances

PM_INDOM_NULL instance domain
data structures
Data Structures
Data Structures
description
Performance Metric Instances
pmAddProfile function
pmAddProfile Function
pmDelProfile function
pmDelProfile Function

PM_SEM_COUNTER semantic type
Semantics

PM_SEM_DISCRETE semantic type
Semantics

PM_SEM_INSTANT semantic type
Semantics
Data Structures

PM_TYPE_AGGREGATE type
Performance Metric Descriptions

PM_TYPE_NOSUPPORT value
Management of Evolution within a PMDA
Performance Metric Descriptions

PM_TYPE_STRING type
Performance Metric Descriptions
pmExtractValue Function

PM_VAL_INSITU value
Performance Metrics Values

pmAddProfile function
Overview
PMAPI Context Services
pmAddProfile Function

PMAPI
Application and Agent Development
Performance Metric Instances
See Also metrics
acronym
Acronyms
ancillary support services
PMAPI Ancillary Support Services
application compiling
Compiling and Linking PMAPI Applications
archive-specific services
pmGetArchiveLabel Function
client development
Client Development and PMAPI
context services
PMAPI Context Services
current context
Current PMAPI Context
description
PMAPI--The Performance Metrics API
description services
pmLookupDesc Function
error handling
PMAPI Error Handling
Handling PMAPI Errors
identifying metrics
Naming and Identifying Performance Metrics
initializing new metrics
Initializing New Metrics
instance domain services
pmGetInDom Function
introduction
Programming Performance Co-Pilot
iterative processing
Iterative Processing of Values
man page
Distributed Collection
metrics services
pmFetch Function
Name Space services
pmGetChildren Function
program evolution
Accommodating Program Evolution
programming issues
PMAPI Programming Issues and Examples
PMAPI Programming Issues and Examples
programming style
PMAPI Programming Style and Interaction
record-mode services
pmRecordAddHost Function
time control services
PMAPI Time Control Services
timezone services
pmNewContextZone Function
variable length arguments
Variable Length Argument and Results Lists

pmAtomStr function
Management of Evolution within a PMDA
pmAtomStr Function

pmAtomValue structure
Simple PMDA

PMCD
acronym
Acronyms
distributed collection
Distributed Collection
overview
PCP Architecture
pmReconnectContext function
pmReconnectContext Function

PMCD_RECONNECT_TIMEOUT variable
pmReconnectContext Function

PMCD_REQUEST_TIMOUT variable
pmFetch Function

pmchart command
PCP Architecture
Implementing a PMDA
Configuring the Trace PMDA

pmclient tool
Application and Agent Development
brief description
Application and Agent Development

pmConvScale function
Management of Evolution within a PMDA
pmConvScale Function

PMCS
Client Development and PMAPI
Acronyms

PMDA
acronym
Acronyms
architecture
PMDA Architecture
checklist
Implementing a PMDA
development
PMDA Development
evolution
Management of Evolution within a PMDA
help text
PMDA Help Text
initialization
Initializing a PMDA
Install script
Installing a PMDA
Upgrading a PMNS to Include Metrics from a New PMDA
integration
Integration of PMDA
introduction
Programming Performance Co-Pilot
man page
Distributed Collection
removal
Removing a PMDA
structures
PMDA Structures
trace
Trace PMDA
writing
Writing a PMDA

pmda tool
See PMDA

PMDA_PMID macro
Data Structures

pmdacisco man page
Caching PMDA

pmdaConnect man page
PMDA Structures
Daemon Initialization

pmdaDaemon man page
PMDA Structures
Daemon Initialization

pmdaDesc callback
Overview

pmdaDSO man page
PMDA Structures

pmdaExt structure
Overview
PMDA Structures

pmdaFetch callback
Overview
Trivial PMDA

pmdaGetOpt man page
PMDA Structures
Daemon Initialization
Daemon Initialization

pmdaIndom structure
Data Structures

pmdaInit man page
Data Structures
PMDA Structures
Common Initialization
Common Initialization

pmdaInstance callback
Overview

pmdaInstid structure
Data Structures

pmdaInterface structure
PMDA Structures
Overview

pmdaMain man page
Daemon Initialization

pmdaMetric structure
Data Structures

pmdaOpenLog man page
Daemon Initialization

pmdaProfile callback
Overview

pmdaStore callback
Overview
simple_store in the Simple PMDA

pmdaText callback
Overview

pmdatrace man page
Performance Instrumentation and Tracing
Performance Instrumentation and Tracing

pmdbg man page
Overview
Debugging Information

pmDelProfile function
PMAPI Context Services
pmDelProfile Function

pmDesc structure
Data Structures
Management of Evolution within a PMDA
Performance Metric Descriptions
Performance Metric Descriptions

pmDestroyContext function
pmDestroyContext Function

pmDupContext function
PMAPI Context Services
pmDupContext Function

pmErrStr function
pmErrStr Function

pmExtractValue function
Management of Evolution within a PMDA
pmExtractValue Function
pmConvScale Function

pmFetch function
Performance Metrics Values
Performance Metrics Values
Variable Length Argument and Results Lists
PMAPI Context Services
pmNewContext Function
pmSetMode Function
pmFetch Function
pmFetch Function
pmFreeResult Function
pmFetchArchive Function
pmPrintValue Function
pmSortInstances Function
Symbolic Association between a Metric's Name and Value

pmFetch man page
Overview
Management of Evolution within a PMDA

pmFetchArchive function
PMAPI Context Services
pmSetMode Function
pmFetchArchive Function

pmflush function
pmflush Function

pmFreeResult function
Variable Length Argument and Results Lists
pmFetch Function
pmFreeResult Function

pmgadgets command
Implementing a PMDA

pmgenmap tool
Application and Agent Development

pmGetArchiveEnd function
PMAPI Context Services
pmGetArchiveEnd Function

pmGetArchiveLabel function
PMAPI Context Services
pmGetArchiveLabel Function

pmGetChildren function
Variable Length Argument and Results Lists
pmGetChildren Function
pmGetChildrenStatus Function
PMAPI Context Services

pmGetChildrenStatus function
PMAPI Context Services

pmGetInDom function
Overview
Variable Length Argument and Results Lists
pmGetInDom Function
PMAPI Context Services
pmSetMode Function
pmGetInDomArchive Function

pmGetInDomArchive function
PMAPI Context Services
pmGetInDomArchive Function

pmGetPMNSLocation function
pmGetPMNSLocation Function
PMAPI Context Services

PMID
acronym
Acronyms
introduction
Name Space

pmIDStr function
pmIDStr Function

pmie command
Implementing a PMDA
Configuring PCP Tools

pmieconf command
Implementing a PMDA
Configuring PCP Tools

pmInDomStr function
pmInDomStr Function

pmLoadNameSpace function
pmLoadNameSpace Function
pmLoadASCIINameSpace Function

pmlogger command
Implementing a PMDA
Configuring PCP Tools

pmlogger_daily command
Configuring PCP Tools

pmLookupDesc function
Overview
Data Structures
Management of Evolution within a PMDA
pmLookupDesc Function
PMAPI Context Services
pmSetMode Function
pmExtractValue Function
pmConvScale Function

pmLookupInDom function
pmLookupInDom Function
PMAPI Context Services
pmSetMode Function

pmLookupInDomArchive function
PMAPI Context Services
pmLookupInDomArchive Function

pmLookupInDomText function
pmLookupInDomText Function
PMAPI Context Services

pmLookupName function
pmLookupName Function
PMAPI Context Services
Symbolic Association between a Metric's Name and Value

pmLookupText function
Overview
Management of Evolution within a PMDA
Variable Length Argument and Results Lists
pmLookupText Function
PMAPI Context Services

pmNameAll function
pmNameAll Function

pmNameID function
Variable Length Argument and Results Lists
pmNameID Function
PMAPI Context Services

pmNameInDom function
Variable Length Argument and Results Lists
pmNameInDom Function
PMAPI Context Services
pmSetMode Function

pmNameInDomArchive function
PMAPI Context Services
pmNameInDomArchive Function

pmNewContext function
pmNewContext Function

pmNewContextZone function
pmNewContextZone Function

pmNewZone function
pmNewZone Function

PMNS
acronym
Acronyms
distributed
Distributed PMNS
upgrade
Upgrading a PMNS to Include Metrics from a New PMDA

pmns man page
Name Space

pmNumberStr function
pmNumberStr Function

pmParseInterval function
pmParseInterval Function

pmParseMetricSpec function
pmParseMetricSpec Function

pmprintf function
pmprintf Function

pmPrintValue function
Management of Evolution within a PMDA
pmPrintValue Function

pmReconnectContext function
pmReconnectContext Function

pmRecordAddHost function
pmRecordAddHost Function

pmRecordControl function
pmRecordControl Function

pmRecordSetup function
pmRecordSetup Function

pmSetMode function
PMAPI Context Services
pmSetMode Function
pmGetArchiveEnd Function

pmSortInstances function
pmSortInstances Function

pmstore function
Overview
Metrics
Management of Evolution within a PMDA
simple_store in the Simple PMDA
Debugging Information
Performance Metrics Values
PMAPI Context Services
pmStore Function
pmStore Function

PMTRACE_STATE_API flag
Configuring the Trace Library

PMTRACE_STATE_ASYNC flag
Configuring the Trace Library

PMTRACE_STATE_COMMS flag
Configuring the Trace Library

PMTRACE_STATE_NOAGENT flag
Configuring the Trace Library
Configuring the Trace Library

PMTRACE_STATE_NONE flag
Configuring the Trace Library

PMTRACE_STATE_PDU flag
Configuring the Trace Library

PMTRACE_STATE_PDUBUF flag
Configuring the Trace Library

pmtraceabort function
Transactions

pmtracebegin function
Transactions

pmtracend function
Transactions

pmtraceobs function
Observations and Counters

pmtracepoint function
Point Tracing
Observations and Counters

pmtracestate call
Configuring the Trace Library

pmTraversePMNS function
pmTraversePMNS Function
PMAPI Context Services

pmTypeStr function
Management of Evolution within a PMDA
pmTypeStr Function

pmUnitsStr function
pmUnitsStr Function

pmUnloadNameSpace function
pmUnloadNameSpace Function

pmUseContext function
pmNewContext Function
pmUseContext Function

pmUseZone function
pmUseZone Function

pmview command
PCP Architecture
Implementing a PMDA

pmWhichContext function
pmWhichContext Function

pmWhichZone function
pmWhichZone Function

point tracing
Point Tracing

program evolution
Accommodating Program Evolution

programming components
Programming Performance Co-Pilot

protocol data units
See PDU

record-mode services
pmRecordAddHost Function

removal script
Removing a PMDA

restarting pmcd
Installing a PMDA

retrospective analysis
Retrospective Sources of Performance Metrics

ring buffers
Rolling-Window Periodic Sampling

rolling-window sampling
Sampling Techniques
Rolling-Window Periodic Sampling

sample duration
Rolling-Window Periodic Sampling
Configuring the Trace PMDA

sampling techniques
Sampling Techniques

scale and dimensionality
Performance Metric Descriptions

semantic types
Semantics

sequential log files
Implementing a PMDA

service time
Instrumenting Applications to Export Performance Data

shell process
Shell Process Method

simple periodic sampling
Simple Periodic Sampling

simple PMDA
2 branches, 4 metrics
Name Space
as daemon
Daemon PMDA
DSO
DSO PMDA
initialization
Simple PMDA
pmdaFetch callback
Simple PMDA

simple_init function
DSO PMDA
DSO PMDA
Simple PMDA
Simple PMDA

simple_store function
Debugging Information

simple.color metric
Simple PMDA

simple.now metric
Simple PMDA

simple.store metric
simple_store in the Simple PMDA

simple.time metric
Simple PMDA

snapshot files
Implementing a PMDA

software
Overview of Component Software

specific instance domain
PMAPI Context Services

sproc man page
Latency and Threads of Control

state flags
Configuring the Trace Library
Configuring the Trace Library

storage of metrics
Metrics

symbolic association
Symbolic Association between a Metric's Name and Value

synchronous protocol
Configuring the Trace Library

target domain
Implementing a PMDA
Metrics
Extracting the Information

TCP/IP
Configuring the Trace Library
Acronyms

testing and debugging
Testing and Debugging a PMDA

threaded applications
Library Reentrancy and Threaded Applications

time control services
PMAPI Time Control Services

timezone services
pmNewContextZone Function

tool configuration
Configuring PCP Tools

toolkit approach
Instrumenting Applications to Export Performance Data

trace facilities
Programming Performance Co-Pilot

trace PMDA
command-line options
Configuring the Trace PMDA
description
Trace PMDA
design
Trace PMDA Design

trace.control.reset metric
Configuring the Trace PMDA

trace.observe metrics
Observations and Counters

trace.observe.rate metric
Sampling Techniques

trace.point.count metric
Point Tracing

trace.point.rate metric
Point Tracing
Sampling Techniques

trace.transact.ave_time metric
Sampling Techniques
Transactions

trace.transact.count metric
Transactions

trace.transact.max_time metric
Transactions
Sampling Techniques

trace.transact.min_time metric
Transactions
Sampling Techniques

trace.transact.rate metric
Transactions
Sampling Techniques

trace.transact.total_time metric
Transactions

transactions
Transactions

trivial PMDA
callbacks
Trivial PMDA
initialization
Trivial PMDA
singular metric
Data Structures

trivial_init function
Trivial PMDA
Trivial PMDA

two or three dimensional arrays
N Dimensional Data

type field
Management of Evolution within a PMDA

unavailable metrics support
Management of Evolution within a PMDA

working buffers
Application Interaction
Rolling-Window Periodic Sampling