6.1
Table Of Contents
- Endpoint Operations Management Agent Plug-in Development Kit
- Contents
- About the Endpoint Operations Management Agent Plug-in Development Kit
- Introduction to Plug-in Development
- The Role of the Server and Agent in Plug-ins
- Technical Overview
- Plug-in Implementations
- Using Support Classes to Simplify a Plug-in
- Writing Plug-ins
- JMX Plug-in
- Script Plug-ins
- SNMP Plug-in
- JMX-Based Management
- Auto-Discovery of JMX Resources
- Configuration Properties for JMX Monitoring
- Creating a Custom JMX Plug-in
- Defining Service Types to Provide Management via Custom MBeans
- Defining an ObjectName to Access Custom MBeans
- Defining Configuration Properties to Appear in the User Interface
- Defining and Gathering Metrics
- Specifying the Availability Metric for MBeans
- Implementing Control Actions
- Defining the Server Auto-Inventory Element
- Discovering Custom Properties
- Running and Testing Plug-ins from the Command Line
- Using Auto-Discovery Support Classes in Plug-ins
- Working with Plug-in Descriptors
- Plug-In Support Classes
- Index
Argument Description
-Dmetric-collect=default Limits the results to metrics that have the defaultOn option set to true.
-Dmetric-indicator=true Limits the results to metrics that have the indicator option set to true.
-Dmetric-cat=CATEGORY
Limits the results to metrics of a specific category. The categories that are available are
AVAILABILITY , UTILIZATION, THROUGHPUT, or PERFORMANCE.
-Dmetric-iter=ITERATIONS
Causes the time, in milliseconds, to collect a metric repeatedly
-DOption=Value
Specifies the value of a resource configuration option.
The command line must include a -DOption=Value for each resource configuration
option.
Example Invocations
In the following examples, only the method invocation and command options are shown. The java -jar
AgentHome/bundles/AgentBundle/pdk/lib/dcs-tools-pdk-VERSION.jar portion of the command is not
shown.
Command Purpose Comments
-m metric -p jboss -t "JBoss 4.2" -m metric -
Djava.naming.provider.url=jnp://0.0.0.0:2099 -
Dserver.log_track.files=../../../logs/server.log -
Dprogram=/Applications/HQEE42GA/server-4.2.0-EE/hq-
engine/bin/run.sh
To fetch metrics
for a JBoss server.
Resource configuration data
is supplied on the command
line
-m metric plugin-
properties/jboss-4.2/melba_HQ_jBoss_4.x.properties
To fetch metrics
for the jboss server
supplying the
configuration data
using a properties
file.
Resource configuration data
is supplied by a properties
file.
Add -Dmetric-collect=default to the command line.
To limit the results
to indicator
metrics.
If you use this option, do
not use -Dmetric-
cat=CATEGORY or -
Dmetric-
indicator=true .
Add -Dmetric-cat=CATEGORY to the command line, where
CATEGORY is AVAILABILITY, UTILIZATION, THROUGHPUT, or
PERFORMANCE.
To limit the results
to metrics of a
specific category.
If you use this option, do
not use -Dmetric-
collect=default or -
Dmetric-
indicator=true .
Add -Dmetric-indicator=true to the command line.
To limit the results
to indicator
metrics.
If you use this option, do
not use -Dmetric-
collect=default or -
Dmetric-cat=CATEGORY.
Add -Dmetric-iter=ITERATIONS to the command line where
ITERATIONS is the number of times to run getValue for each
metric .
To collect each
metric multiple
times and report
how long it took to
do so (in
milliseconds),
instead reporting
the metric value.
You can use this option in
conjunction with one of the
following:
n
-Dmetric-
collect=default
n
-Dmetric-
cat=CATEGORY
n
-Dmetric-
indicator=true
Add -m metric plugin-
properties/jboss-4.2/melba_HQ_jBoss_4.x.properties -a
translate to the command line.
To fetch the metric
template, but not
the metrics, for the
JBoss server.
Chapter 1 Introduction to Plug-in Development
VMware, Inc. 33