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
Using AUTOINVENTORY_NAME
You can overwrite a discovered object name by defining a new qualifier. The format of this name is a single
string containing variables (%variable1%) that map to configuration options. Three types of properties are
passed to formatting functions as ConfigResponse objects, the parent resource, the resource itself, and
custom resource properties.
CAUTION The AUTOINVENTORY_NAME property is used only if the auto-discovery implementation calls the
appropriate formatting functions.
Using INVENTORY_ID
The INVENTORY_ID property, sometimes referred to as the auto-inventory ID, is used to identify unique
objects within discovered object types. The vRealize Operations Manager server verifies whether an object
in an auto-discovery report is already in the inventory by checking to see if an object with that INVENTORY_ID
already exists.
Implementing Methods
This interface implements the following methods.
setDescription(String):v
oid
protected void setDescription(String description)
This method sets the server description. It allows you to set the description
outside of the ServerResource object. This enables you to update the server
description while discovering new services, However some rules apply. If
discoverServers() discovers something or discoverServices() does not
discover anything, this field is ignored.
Parameters: description The server description.
setCustomProperties(C
onfigResponse):void
protected void setCustomProperties(ConfigResponse cprops)
This method sets the custom properties for the server. It allows you to set
custom properties outside of the ServerResource object. This enables you to
update server custom properties while discovering new service objects. Some
rules apply. If discoverServers() discovers something, or
discoverServices() does not discover anything, this field is ignored.
Parameters: cprops Server custom properties
discoverServers(Config
Response):List
protected List discoverServers(ConfigResponse config)
This is a runtime method for discovering new servers. Override this method
to discover servers for the server object of the plug-in instance. Most plug-ins
override discoverServices(), rather than {{discoverServers()}.
discoverServers()} is typically used in the case in which a plug-in interface,
FileServerDetector or AutoServerDetector, finds an administration server
object, then discoverServers() discovers managed server nodes. Examples
of this usage are found in vRealize Operations Manager WebLogic,
WebSphere, and iPlanet plug-ins.
This method returns NULL if it is not overwritten.
Parameters: Parent configuration
Returns:
A list of ServerResource objects.
Chapter 4 Plug-In Support Classes
VMware, Inc. 63