Go to main content
1/29
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's Changed in this Guide?
1
Getting Started with Plug-in Development
1.1
About the Plug-in Creation Process
1.2
About the Extensibility Development Kit (EDK)
1.2.1
Contents of the EDK
1.3
Installing the Extensibility Development Kit (EDK)
1.4
Designing the Plug-in
1.5
Creating a Basic Plug-in
1.6
Creating an Intermediate Plug-in
1.7
Creating an Advanced Plug-in
2
Defining the Plug-in
2.1
Introduction to Defining the Plug-in
2.2
Basic Plug-in Metadata
2.2.1
Defining the Plug-in ID
2.2.2
Defining the Plug-in Version
2.3
Creating Plug-in Definition Files
2.4
Creating the plugin.xml File
2.4.1
Overview of plugin.xml Elements
2.4.2
Certifying Plug-ins
2.5
Creating the plugin_registry.xml File
2.5.1
Overview of plugin_registry.xml Elements
2.6
Validating the Plug-in Definition Files
2.7
Adding Log Viewer Support to Your Plug-in
2.8
Defining Plug-ins for Upgrade
3
Creating Target Metadata Files
3.1
Introduction to Creating Target Metadata Files
3.2
Overview of Target Definition Files
3.3
Creating the Target Type Metadata File
3.3.1
Creating a Basic Target Type Metadata File
3.3.2
Naming the Target Type Metadata File
3.3.3
Defining the Target Type Metadata
3.3.4
Defining Target Credentials
3.3.5
Defining Type Properties
3.3.6
Defining Instance Properties
3.3.6.1
Static Instance Properties
3.3.6.2
Dynamic Instance Properties
3.4
Defining Metrics to Collect from the Target
3.4.1
Metric Definition Files
3.4.2
Defining the Basic Response Metric Group
3.4.3
Defining Advanced Metrics
3.4.4
Defining Repository Metrics
3.4.5
Categorizing Metrics
3.4.6
Defining Adaptive Thresholds
3.4.7
Overview of Key Metric Metadata Elements
3.4.8
Troubleshooting Metric Definitions
3.5
Creating the Default Collection File
3.5.1
Grouping Similar Metrics For Collection
3.5.2
Defining Basic Metric Collection
3.5.3
Defining Advanced Metric Collection
3.5.4
Defining Target Configuration Data Collections
3.5.5
Overview of Key Default Collection Metadata Elements
3.5.6
Troubleshooting the Collection Process
3.6
Guidelines for Creating Target Metadata
3.6.1
Defining Target Metadata
3.6.1.1
Metadata Version
3.6.1.2
Real-time Only Metrics
3.6.1.3
Choice of Key Columns
3.6.1.4
Transient Columns
3.6.1.5
Rate Metrics
3.6.1.6
Metrics and Microsoft Windows
3.6.1.7
Target Properties (Static Versus Dynamic)
3.6.1.8
Metrics
3.6.2
Defining Collections
3.6.2.1
Alert Message Guidelines
3.6.2.2
Metric Evaluation Order
3.6.2.3
Collection Frequency
3.6.2.4
Controlling Number of Rows
3.7
Localizing Target Metadata
3.7.1
About Target Metadata Localization
3.7.2
Define the Resource Bundle Package
3.7.3
Localize Metric Messages
3.7.4
Package Resource Bundles
3.7.4.1
About Resource Property Bundle Content
3.7.4.2
Packaging Resource Bundles
3.8
Checking a New Target Type
3.9
Testing Your Target Type Definitions
3.9.1
Activate the Metric Browser
3.9.2
View Your Metrics
3.10
Validating Your Metadata XML
3.11
Troubleshooting the Target Creation Process
4
Plug-in Builder
4.1
Overview
4.2
Prerequisites For Using Plug-in Builder
4.3
Installing Plug-in Builder
4.3.1
Installing Plug-in Builder and a New JDeveloper Instance
4.3.2
Installing Plug-in Builder into an Existing JDeveloper Instance
4.4
Creating an Enterprise Manager Plug-in Project
4.5
Creating a Plug-in Project Using Sample Plug-ins
4.6
Discovering Targets
4.6.1
Updating Discovery Metadata for a Pre-existing Plug-in
4.6.2
Viewing Basic Discovery Information
4.7
Importing and Deploying the Plug-in Archive into Enterprise Manager
4.8
Adding a New Target Type
4.9
Updating Target Type Information
4.9.1
Adding Instance Properties
4.9.2
Adding Dynamic Properties
4.9.3
Adding Credential Type
4.9.4
Adding Credential Set
4.9.5
Adding Metric Properties for a Target
4.9.5.1
Adding ColumnDescriptor
4.9.5.2
Adding QueryProperties
4.9.5.3
Adding ExecutionDescriptor Table
4.9.5.4
Adding ExecutionDescriptor View
4.9.5.5
Configuring Collection Items for a Target
4.10
Adding a Collection Item for the Target
4.11
Inserting or Updating Collection Item Properties
4.12
Deinstalling Plug-in Builder
4.13
Appendix
4.13.1
Using the Structure View
4.13.2
Using Property Inspector
4.13.3
Directory Structure for a Plug-in Project
5
Adding Information Publisher Reports
5.1
Introduction to Adding Information Publisher Reports
5.1.1
Assumptions and Prerequisites
5.2
Overview of SYSTEM Reports
5.2.1
About the Report Definitions Page
5.3
Understanding the Report Definition File
5.4
Creating a Report Definition File
5.4.1
About the Report Definition File Development Process
5.4.2
About the Report Lifecycle: Updating Report Definitions
5.5
Understanding the XML Report Definition Interface
5.5.1
About Report Definition Tags
5.5.1.1
<ReportDefinition>
5.5.1.2
<ReportElement>
5.5.1.3
<ReportElementParamters>
5.5.2
Using Element Parameters
5.5.2.1
About Table Element Parameters
5.5.2.2
About the Chart Element
5.5.3
Understanding the Metric Details Element
5.5.4
Using Text Element Parameters
5.5.5
About Report-Wide Parameters
5.6
Using the ImportExport.xsd File
5.7
About Enterprise Manager Command Line Interface (EM CLI) Verbs
5.8
About Development Guidelines
6
Developing BI Publisher Reports
6.1
Introduction to Oracle BI Publisher
6.1.1
Assumptions and Prerequisites
6.2
Training and Resources
6.3
About the Report Data Source
6.4
Developing a Report
6.5
Using the Enterprise Manager EDK for Staging and Deploying BI Publisher Reports
7
Collecting Target Configuration Data
7.1
Introduction to Collecting Target Configuration Data
7.1.1
Assumptions and Prerequisites
7.2
About the Configuration Definition Files
7.3
Modeling Enterprise Configuration Management Tables
7.3.1
Defining Configuration Collection Tables
7.3.1.1
EM_ECM_OH_HOME_INFO Table
7.3.1.2
EM_ECM_OH_DEP_HOMES Table
7.3.1.3
EM_ECM_OH_COMPONENT Table
7.3.1.4
EM_ECM_OH_COMP_INST_TYPE Table
7.3.1.5
Additional Information About the Configuration Metadata
7.3.2
Overview of Configuration Management Snapshot Metadata Elements
7.3.3
Packaging Configuration Metadata
7.3.4
Registering Metadata With the Configuration Management Framework
7.3.5
Supporting Translation
7.3.6
Upgrading Configuration Data
7.3.7
Modifications to Standard Collection Metrics and RAW Metrics
7.3.8
Testing the Configuration Collection Data
7.3.9
Troubleshooting
8
Adding Job Types
8.1
Introduction to Adding Job Types
8.2
About Job Types
8.3
Introducing New Job Types
8.4
Specifying a New Job Type in XML
8.4.1
Understanding Job Type Categories
8.4.2
Using Agent-Bound Job Types
8.4.3
About Job Steps
8.4.3.1
Affecting the Status of a Stepset
8.4.3.2
Passing Job Parameters
8.4.3.3
About Job Step Output and Errors
8.5
Using Commands
8.5.1
Using the remoteOp Command
8.5.2
Using the fileTransfer Command
8.5.3
About the putFile Command
8.5.4
Using the getFile Command
8.5.5
Using the execAndSuspend Command
8.6
About Command Error Codes
8.7
Executing Long-Running Commands at the Oracle Management Service
8.7.1
Configuring the Job Dispatcher to Handle Long-Running Commands
8.8
Specifying Parameter Sources
8.8.1
Understanding SQLParameter Source
8.8.1.1
Using a PL/SQL Procedure to Fetch Scalar and Vector Parameters
8.8.2
About the User Parameter Source
8.8.3
About the Inline Parameter Source
8.8.4
Using the checkValue Parameter Source
8.8.5
About the properties Parameter Source
8.8.6
Understanding Parameter Sources and Parameter Substitution
8.8.7
About Parameter Encryption
8.9
Specifying Credential Information
8.9.1
About Credential Usage
8.9.2
Overview of Credential Binding
8.9.3
XSD Elements – Credential Usage and Credential Binding
8.10
Specifying Security Information
8.11
Specifying Lock Information
8.12
Suspending a Job or Step
8.13
Restarting a Job
8.13.1
Restarting Versus Resubmitting
8.13.2
Default Restart Behavior
8.13.3
Using the restartMode Directive
8.14
Adding Job Types to the Job Activity and Job Library Pages
8.14.1
Adding a Job Type to the Job Activity Page
8.14.2
Adding a Job Type to the Job Library Page
8.15
Examples: Specifying Job Types in XML
8.16
About Performance Issues
8.16.1
Using Parameter Sources
8.17
Adding a Job Type to Enterprise Manager
9
Defining a Management User Interface
9.1
Introduction to Defining a Management User Interface
9.1.1
Flex Implementation
9.1.2
Metadata-only Implementation
9.1.3
Assumptions and Prerequisites
9.2
MPCUI Concepts
9.2.1
Integration Class
9.2.2
Activity
9.2.3
Page
9.2.4
Services
9.2.4.1
Data Services
9.2.4.2
Operation Services
9.2.4.3
Asynchronous Service Request Handling
9.2.5
URL
9.3
UI Options for a Plug-in
9.3.1
Metadata-only Implementation
9.3.2
Flex Implementation
9.3.2.1
MXML
9.3.2.2
ActionScript
9.3.2.3
SWF Binary File
9.3.2.4
Defining the Home Page
9.4
Creating the MPCUI Metadata File
9.4.1
Overview of MPCUI Metadata Elements
9.5
Defining Metadata
9.5.1
Limitations of the Metadata Implementation
9.5.2
Defining Integration Metadata
9.5.2.1
Defining Pages
9.5.2.2
Mapping Data to UI Components
9.5.3
Defining Navigation
9.6
Defining the MPCUI Application
9.6.1
Defining the Application Activities (Integration Class)
9.6.2
Defining Pages
9.6.2.1
Page Class
9.6.2.2
Page Model
9.6.2.3
Page Controller
9.6.3
Defining Dialogs
9.6.4
Defining Trains and Train Pages
9.6.5
Defining URLs
9.7
Packaging the MPCUI Implementation With the Plug-in
9.8
Converting a Metadata-based UI to a Flex-based UI
9.9
Defining System Home Pages
9.9.1
Defining systemUiIntegration Metadata
9.9.2
Defining System Regions
9.9.2.1
Defining System Status Region
9.9.2.2
Defining System Issues Region
9.9.2.3
Defining the System Job Activity Region
9.10
Defining Navigation
9.10.1
Navigation to Activities
9.10.2
URL and Links
9.10.3
Adding Links to External Applications
9.11
Accessing Enterprise Manager Data
9.11.1
Metric Services
9.11.1.1
Using the Metric Values Service Transparently
9.11.1.2
Using the MetricValuesDataService Tag
9.11.1.3
Calling the Metric Value Service From a Controller
9.11.1.4
Metric Data Source Filters
9.11.2
Custom Data Source
9.11.2.1
Creating the Custom Data Source
9.11.2.2
Binding the Data Source to a UI Component
9.11.2.3
Updating the Custom Data Source
9.11.3
Computed Data Source
9.11.4
Packaged SQL and the Query Service
9.11.4.1
Guidelines for Writing Packaged SQL
9.11.4.2
Packaging SQL in the Plug-In
9.11.4.3
Getting Target Type Information
9.11.5
Working With Target Services
9.11.5.1
Target Properties Service
9.11.5.2
Associated Targets Service
9.11.5.3
Metric Metadata Service
9.11.5.4
Availability Service
9.11.6
Monitoring Service Request Performance
9.11.7
Automated Polling of Service Requests
9.11.8
Batching of Service Requests
9.11.9
Software Library Search Service
9.12
Performing Task Automation
9.12.1
Automation Services
9.12.1.1
Submitting or Running a Job
9.12.1.2
Getting Job Status and Step Details
9.12.1.3
Using a Timer to Periodically Check Job Status
9.12.1.4
Stopping and Deleting a Job
9.12.1.5
Remote Operations
9.12.2
Working With Credentials
9.12.2.1
Retrieving Credential Information
9.12.2.2
Passing Credentials to Jobs and Remote Operations
9.12.2.3
Reusable Credentials UI Components
9.12.2.4
Managing Monitoring Credentials
9.13
Storing Session State
9.14
Defining Page Layout Components
9.14.1
Defining Regions
9.15
Including Packaged Regions
9.15.1
Availability Region
9.15.2
Incidents and Problems Region
9.15.3
Job Summary Region
9.15.4
Credentials Region
9.16
Defining Charts
9.16.1
Line Chart
9.16.1.1
Providing Line Chart Data Source
9.16.1.2
Controlling the Legend
9.16.2
Area Chart
9.16.3
Bar (Horizontal) Chart
9.16.3.1
Grouping Bars
9.16.4
Column (Vertical Bar) Chart
9.16.5
Pie Chart
9.17
Defining Tables
9.17.1
Data Service
9.17.2
Custom Data Provider
9.17.3
Getting Selected Rows
9.18
Defining Dialogs
9.18.1
Dialog Registration
9.18.2
Displaying a Dialog and Waiting for Close Events
9.19
Defining Trains
9.19.1
Train Definition Example
9.19.2
Train Controller
9.19.3
Train State
9.19.4
Train Events
9.20
Defining Information Item and Information Displays (Label-Value Pairs)
9.21
Using Built-in Renderers
9.22
Defining Links
9.23
Including Enterprise Manager Images
9.24
Displaying a Processing Cursor
9.25
Defining a Processing Window
9.26
Defining Icons for Target Types
9.27
Displaying the Target Navigator
9.28
Defining a UI for Guided Discovery
9.28.1
About Guided Discovery
9.28.2
Supporting Guided Discovery
9.28.3
Constructing the Guided Discovery User Interface
9.28.3.1
Discovery Application and Integration Class
9.28.4
Structure of the Discovery Application
9.28.5
Using Discovery Service
9.28.6
Using Target Information Services
9.28.7
Using Target Management Services
9.29
About Logging
9.29.1
Add Logging to your Code
9.29.2
Options for Capturing Log Output
9.29.2.1
Running MPCUI From Adobe Flash Builder
9.29.2.2
Running MPCUI from Enterprise Manager Console
9.30
Development Environment Options
9.30.1
Developing MPCUI with Flex SDK and Apache Ant
9.30.2
Developing MPCUI in Adobe Flash or Flex Builder
9.30.2.1
Configuring Adobe Flash Builder
9.30.2.2
Setting up the Demo Sample Project
9.30.2.3
Running Demo Sample MPCUI from Adobe Flash Builder
9.30.2.4
Elements of the Demo Sample Flex UI
9.30.2.5
Updating the Demo Sample
9.30.2.6
Modifying the Deployed Plug-in
9.30.3
Setting Up an Adobe Flash Builder Project for MPCUI
9.30.3.1
Before You Begin
9.30.3.2
Creating an Adobe Flash Builder Project
9.30.3.3
Setting MPCUI Project Properties
9.30.3.4
Verifying Correct MPCUI Library Linkage
9.30.3.5
Using Earlier SWC Files With a Later Enterprise Manager OMS
9.30.3.6
Understanding MPCUI RSL Caching
9.30.3.7
Clearing Adobe Flash Player Cache
9.31
Migrating Home Page Customizations
9.32
Accessibility Guidelines
9.32.1
Accessibility Options in Enterprise Manager
9.32.2
Summary of Critical Issues
9.32.3
Using MPCUI Components
9.32.4
Controlling Reading and Tabbing Order
9.33
Localization Support
9.33.1
Register Bundles
9.33.2
Reference Strings from MXML (Page, Dialog Definitions)
9.33.3
Access Strings from ActionScript (Controller Code)
9.34
Providing Online Help
10
Customizing Incident Manager
10.1
Introduction to Customizing Incident Manager
10.2
Understanding Supported Customizations
10.3
Creating Event-Specific Customization XML
10.3.1
Overview of Event-Specific Customization Metadata Elements
10.3.2
About Events
10.3.2.1
Common Event Attributes
10.3.2.2
Target Availability Event
10.3.2.3
Metric Alert Event
10.4
Adding Customized Details About the Event
10.5
Providing Content in the Guided Resolution Region
10.5.1
Adding Recommendations using XML
10.5.2
Customizing Sections
10.6
Defining a Search String for My Oracle Support Knowledge
10.7
Defining Conditions for Customization
10.8
Registering Customizations
10.9
Testing Incident Manager After Customization
11
Using Derived Associations
11.1
Introduction to Derived Associations
11.1.1
Assumptions and Prerequisites
11.2
Understanding Enterprise Manager Association Concepts
11.2.1
About Out-of-Box Association Types
11.2.2
Using Association Derivation
11.2.3
About Automated Discovery and Promotion of Associations
11.2.4
Understanding Association Creation During Guided Discovery
11.2.5
Using Associations Derived from a System Stencil
11.2.6
Associations Derived from Rule
11.3
About Association Derivation Rules Management
11.3.1
Using Association Derivation Rules Syntax and Semantics
11.3.2
Understanding XML Metadata File Syntax and Semantics
11.3.3
Using Rule Semantics
11.3.4
Maintaining Performance
11.3.5
About Regular Query and Trigger Patterns
11.3.6
Diagnosing Issues
11.3.7
Useful Examples
11.3.7.1
Host on a Virtual Machine
11.3.7.2
Target installed_at Oracle Home
11.3.7.3
Listener and Database
11.3.8
Applying the Mechanical Steps of Integration
11.3.9
Special Triggers: Host Name Change Triggers
11.3.10
Understanding Activation Expressions
11.3.11
Troubleshooting and Debugging
11.4
Ensuring Performance
11.4.1
Using Custom Configuration Specifications for Data Collection
11.5
Using Overlapping Associations
11.5.1
Overlap Between Associations Derived by Rules
11.6
Creating Associations for Composite and System Target Types
11.6.1
Composite Membership and the Containment Association
11.6.2
Other Non-Composite Associations (Composite Topology)
11.6.3
System Membership Associations
11.6.4
Associations to External Targets
11.6.5
Regarding the Timing of Association Creation
11.7
Frequently Asked Questions
11.7.1
Which tables can I reference in a rule query?
11.7.2
Are there guidelines for when to use target properties?
11.7.3
What is the relationship between discovered and derived associations?
12
Defining Target Discovery
12.1
Introduction to Defining Target Discovery
12.2
Creating Discovery XML
12.2.1
Generic Discovery Integration Example
12.2.2
Discovery Script Example
12.2.3
Overview of the Discovery Metadata Elements
12.3
Creating the Discovery Script
12.3.1
Discovered Targets DTD
12.4
Packaging Discovery XML and Discovery Content
12.4.1
Location of the Discovery Metadata File
12.4.2
Package Discovery Content
12.4.2.1
Java Content Required by Discovery Scripts
12.5
Setting Up and Testing Discovery
12.6
Manually Adding Targets
12.6.1
Manually Adding Host Targets
12.6.2
Manually Adding Non-Host Targets
12.7
Configuring and Promoting Targets for Monitoring by Enterprise Manager
12.8
Examples for Using Generic Discovery Framework
12.8.1
Discovery Integration Example Requiring User Input
12.9
Configuring Automatic Discovery For Plug-ins
13
Adding Compliance Standards
13.1
Introduction to Adding Compliance Standards
13.1.1
Assumptions and Prerequisites
13.2
About the Compliance Standard Rules
13.2.1
Defining Repository Check-based Rules
13.2.2
Defining Real-time Monitoring Rules
13.2.2.1
What Entity Types Can I Monitor?
13.2.2.2
About Real-time Monitoring Facets
13.2.2.3
Creating Real-time Monitoring Facets
13.2.2.4
Creating Real-time Monitoring Facets for Time Windows
13.2.2.5
Creating Real-time Monitoring Rules
13.3
Defining Compliance Standards
13.4
Defining a Compliance Framework
13.5
Defining Compliance Content
13.6
Removing Compliance Content
13.7
Supporting Translation
13.8
Packaging Compliance XML
13.9
Setting Up and Testing Compliance Standards and Rules
13.9.1
Install Compliance Content
13.9.2
Test Compliance Standard
13.9.3
Constraints for Testing
13.10
More Compliance Examples
13.11
Publishing Compliance Content Using Self Update
14
Validating, Packaging, and Deploying the Plug-in
14.1
Introduction to Validating, Packaging, and Deploying the Plug-in
14.2
Staging the Plug-in
14.3
Validating the Plug-in
14.4
Creating the Plug-in Archive
14.5
Importing and Deploying the Plug-in Archive into Enterprise Manager
14.5.1
Prerequisites for Importing the Plug-in
14.5.1.1
Setting Up the Software Library
14.5.1.2
Setting Up the EM CLI Utility
14.5.2
Importing the Plug-in Archive
14.5.3
Deploying the Plug-in on Oracle Management Service (OMS)
14.5.4
Important Details Regarding Plug-in Deployment
14.6
Adding a Target Instance
14.7
Updating Deployed Metadata Files Using the Metadata Registration Service (MRS)
14.7.1
Target Types and Default Collections
15
Defining Software Library Metadata
15.1
Introduction to Software Library Framework
15.2
Defining Software Library Metadata
15.2.1
Defining Folders
15.2.2
Defining Types
15.2.3
Defining Subtypes
15.2.3.1
Entity Properties File
15.2.4
Defining Entities
15.3
Organizing Software Library Metadata Files
15.4
Adding the Software Library Metadata to Enterprise Manager
15.4.1
Step 1: Validating Metadata XML
15.4.2
Step 2: Adding Metadata XML to OPAR
15.5
Using Software Library Entities
15.5.1
Using Job Types
15.5.2
Using EMCLI Verbs
16
Defining Credentials
16.1
Introduction to Security Concepts
16.1.1
Understanding Credential Types
16.1.2
About Named Credentials
16.1.3
Authenticating Target Types
16.1.4
Overview of Credential Sets
16.1.5
Using the Credential Store
16.1.6
About the Credential Reference
16.2
Defining Credential Metadata
16.2.1
Overview of Credential Elements
17
Defining a Chargeback Entity Type
17.1
Chargeback Extensibility Toolkits
17.2
Steps to Develop and Test New Chargeback Entity Type
17.3
The Chargeback Model
17.4
Sample Chargeback MDS XML File
17.5
Registering the Chargeback MDS
17.6
Testing the Entity Type Plug-in
18
Converting an Existing Metadata Plug-in
18.1
Introduction to Converting an Existing Metadata Plug-in
18.2
Impact of the New Plug-in Framework on Existing Plug-ins
18.2.1
Plug-in Metadata Must Be Converted to the New Format
18.2.2
Plug-ins Must Be Packaged as Oracle Plug-in Archive (OPAR) Files
18.2.3
In-place Upgrade of Existing Plug-ins Not Supported
18.2.4
Plug-ins Must Be Registered Before Upgrading
18.3
Using the convert_mp Utility to Convert Plug-in Metadata
18.3.1
Converting Plug-In Metadata Stored In A Management Repository
18.3.2
Converting a Metadata Plug-in Archive (MPA)
18.4
Post-Conversion Steps
18.4.1
Modifying the plugin.xml and plugin_registry.xml Files
18.4.2
Converting Report Definitions Created With PL/SQL
18.4.2.1
Named SQL Statements
18.4.2.2
Converting Report Definitions to XML
18.4.3
Converting Job Type Definitions
18.4.4
Packaging the Plug-in
19
Monitoring Using Web Services and JMX
19.1
Overview
19.2
Monitoring Using Web Services in Enterprise Manager
19.2.1
Creating Metadata and Default Collection Files
19.2.1.1
Web Services CLI Command-line Tool Syntax
19.2.1.2
Web Services Command-line Tool Security
19.2.1.3
Generating the Files
19.3
Monitoring Using WS-Management in Enterprise Manager
19.3.1
Creating Metadata and Default Collection Files
19.3.1.1
WS-Management CLI Command-line Tool Syntax
19.3.1.2
Command-line Tool Security
19.3.1.3
Generating Target Metadata and Collection Files
19.4
Monitoring JMX Applications Deployed on Oracle Application Servers (OC4J)
19.4.1
Creating Metadata and Default Collection Files
19.4.1.1
JMX Command-line Tool Syntax
19.4.1.2
Generating the Files
19.4.2
Displaying Target Status Information
19.5
Monitoring a Standalone JMX-instrumented Java Application or JVM Target
19.5.1
Generating Metadata and Default Collection Files
19.5.1.1
JMX Command-line Tool Syntax
19.5.1.2
Generating the Files
19.5.2
Using the Metadata and Default Collection Files
19.6
Monitoring JMX Applications Deployed on Oracle WebLogic Application Servers
19.6.1
Creating Metadata and Default Collection Files using jmxcli
19.6.1.1
JMX Command-line Tool Syntax
19.6.1.2
Generating the Files
19.6.1.3
Displaying Target Status Information
19.6.2
Using the Metadata and Default Collection Files
19.7
Adding a Target to a Management Agent
19.7.1
Adding a Web Services Target - CalculatorService
19.7.2
Adding a WS-Management Target - TrafficLight
19.7.3
Configuring a Standalone Java Application or JVM Target
19.7.4
Adding a Target Instance for a Custom J2EE Application on WebLogic
19.8
Monitoring Credential Setup
19.9
Viewing Monitored Metrics
19.10
Creating JMX Metric Extensions
19.10.1
Using the Enterprise Manager Console
19.10.2
Using the JMXCLI to create a Metric Extension Archive
19.11
Surfacing Metrics from a Standalone JVM or Oracle Coherence
19.11.1
Using the Enterprise Manager Console
19.11.2
Using JMXCLI
20
Using Receivelets
20.1
About Receivelets
20.2
SNMP Receivelet
21
Using Fetchlets
21.1
About Fetchlets
21.2
OS Command Fetchlets
21.2.1
OS Fetchlet
21.2.2
OSLines Fetchlet (split into lines)
21.2.3
OSLineToken Fetchlet (tokenized lines)
21.2.4
Invoke an OS Fetchlet as a Specific User for Metric Collection
21.3
SQL Fetchlet
21.4
SNMP Fetchlet
21.5
HTTP Data Fetchlets
21.5.1
URL Fetchlet (raw)
21.5.2
URL Lines Fetchlet (split into lines)
21.5.3
URL Line Token Fetchlet (tokenized lines)
21.6
URLXML Fetchlet
21.7
URL Timing Fetchlet
21.8
Dynamic Monitoring Service (DMS) Fetchlet
21.8.1
Advantages to Using DMS for Oracle Management Agent Integration
21.8.2
DMS Fetchlet/Oracle Management Agent Integration Instructions
21.8.2.1
Integrating DMS Data with the Management Agent
21.9
JDBC Fetchlet
21.10
WBEM Fetchlet
21.11
JMX Fetchlet
21.12
Web Services Fetchlet
21.12.1
Using Credentials for Authentication
21.13
WS-Management Fetchlet
21.13.1
Using Credentials
21.14
REST Fetchlet
21.14.1
Response Processing
21.14.2
Using HTTPS and Self-Signed Certificates
21.14.3
Using REST CLI to Generate Metadata
22
Enterprise Manager DTD
22.1
Terminology
22.2
Target Metadata DTD Elements
22.2.1
TargetMetadata
22.2.1.1
Attributes
22.2.1.2
Elements
22.2.1.3
Used In
22.2.1.4
Examples
22.2.2
Display
22.2.2.1
Attributes
22.2.2.2
Elements
22.2.2.3
Used In
22.2.2.4
Examples
22.2.3
SSH_ERROR_MSG
22.2.3.1
Attributes
22.2.3.2
Elements
22.2.3.3
Used In
22.2.3.4
Examples
22.2.4
TypeProperties
22.2.4.1
Attributes
22.2.4.2
Elements
22.2.4.3
Used In
22.2.4.4
Examples
22.2.5
TypeProperty
22.2.5.1
Attributes
22.2.5.2
Elements
22.2.5.3
Used In
22.2.5.4
Examples
22.2.6
AssocTarget
22.2.6.1
Attributes
22.2.6.2
Elements
22.2.6.3
Used In
22.2.6.4
Examples
22.2.7
AssocPropDef
22.2.7.1
Attributes
22.2.7.2
Elements
22.2.7.3
Used In
22.2.7.4
Examples
22.2.8
DiscoveryHelper
22.2.8.1
Attributes
22.2.8.2
Elements
22.2.8.3
Used In
22.2.8.4
Examples
22.2.9
DiscoveryHint
22.2.9.1
Attributes
22.2.9.2
Elements
22.2.9.3
Used In
22.2.9.4
Examples
22.2.10
MetricClass
22.2.10.1
Attributes
22.2.10.2
Elements
22.2.10.3
Used In
22.2.10.4
Examples
22.2.11
MetricCategory
22.2.11.1
Attributes
22.2.11.2
Elements
22.2.11.3
Used In
22.2.11.4
Examples
22.2.12
Metric
22.2.12.1
Attributes
22.2.12.2
Elements
22.2.12.3
Used In
22.2.12.4
Examples
22.2.13
ValidIf
22.2.13.1
Attributes
22.2.13.2
Elements
22.2.13.3
Used In
22.2.13.4
Examples
22.2.14
CategoryProp
22.2.14.1
Attributes
22.2.14.2
Elements
22.2.14.3
Used In
22.2.14.4
Examples
22.2.15
ValidMidTierVersions
22.2.15.1
Attributes
22.2.15.2
Elements
22.2.15.3
Used In
22.2.15.4
Examples
22.2.16
TableDescriptor
22.2.16.1
Attributes
22.2.16.2
Elements
22.2.16.3
Used In
22.2.16.4
Examples
22.2.17
ColumnDescriptor
22.2.17.1
Attributes
22.2.17.2
Elements
22.2.17.3
Used In
22.2.17.4
Examples
22.2.18
CategoryValue
22.2.18.1
Attributes
22.2.18.2
Elements
22.2.18.3
Used In
22.2.18.4
Examples
22.2.19
CustomTableMapper
22.2.19.1
Attributes
22.2.19.2
Elements
22.2.19.3
Used In
22.2.19.4
Examples
22.2.20
ColumnMapper
22.2.20.1
Attributes
22.2.20.2
Elements
22.2.20.3
Used In
22.2.20.4
Examples
22.2.21
QueryDescriptor
22.2.21.1
Attributes
22.2.21.2
Elements
22.2.21.3
Used In
22.2.21.4
Examples
22.2.22
Property
22.2.22.1
Attributes
22.2.22.2
Elements
22.2.22.3
Used In
22.2.22.4
Examples
22.2.23
Label
22.2.23.1
Attributes
22.2.23.2
Elements
22.2.23.3
Used In
22.2.23.4
Examples
22.2.24
ShortName
22.2.24.1
Attributes
22.2.24.2
Elements
22.2.24.3
Used In
22.2.24.4
Examples
22.2.25
Icon
22.2.25.1
Attributes
22.2.25.2
Elements
22.2.25.3
Used In
22.2.25.4
Examples
22.2.26
Description
22.2.26.1
Attributes
22.2.26.2
Elements
22.2.26.3
Used In
22.2.26.4
Examples
22.2.27
Unit
22.2.27.1
Attributes
22.2.27.2
Elements
22.2.27.3
Used In
22.2.27.4
Examples
22.2.28
MonitoringMode
22.2.28.1
Attributes
22.2.28.2
Elements
22.2.28.3
Used In
22.2.28.4
Examples
22.2.29
AltSkipCondition
22.2.29.1
Attributes
22.2.29.2
Elements
22.2.29.3
Used In
22.2.29.4
Examples
22.2.30
CredentialInfo
22.2.30.1
Attributes
22.2.30.2
Elements
22.2.30.3
Used In
22.2.30.4
Examples
22.2.31
CredentialType
22.2.31.1
Attributes
22.2.31.2
Elements
22.2.31.3
Used In
22.2.31.4
Examples
22.2.32
CredentialTypeColumn
22.2.32.1
Attributes
22.2.32.2
Elements
22.2.32.3
Used In
22.2.32.4
Examples
22.2.33
CredentialTypeColumnValue
22.2.33.1
Attributes
22.2.33.2
Elements
22.2.33.3
Used In
22.2.33.4
Examples
22.2.34
CredentialTypeRef
22.2.34.1
Attributes
22.2.34.2
Elements
22.2.34.3
Used In
22.2.34.4
Examples
22.2.35
CredentialTypeRefColumn
22.2.35.1
Attributes
22.2.35.2
Elements
22.2.35.3
Used In
22.2.35.4
Examples
22.2.36
CredentialSet
22.2.36.1
Attributes
22.2.36.2
Elements
22.2.36.3
Used In
22.2.36.4
Examples
22.2.37
CredentialSetColumn
22.2.37.1
Attributes
22.2.37.2
Elements
22.2.37.3
Used In
22.2.37.4
Examples
22.2.38
CredentialSetColumnValue
22.2.38.1
Attributes
22.2.38.2
Elements
22.2.38.3
Used In
22.2.38.4
Examples
22.2.39
InstanceProperties
22.2.39.1
Attributes
22.2.39.2
Elements
22.2.39.3
Used In
22.2.39.4
Examples
22.2.40
InstanceProperty
22.2.40.1
Attributes
22.2.40.2
Elements
22.2.40.3
Used In
22.2.40.4
Examples
22.2.41
DynamicProperties
22.2.41.1
Attributes
22.2.41.2
Elements
22.2.41.3
Used In
22.2.41.4
Examples
22.2.42
ExecutionDescriptor
22.2.42.1
Attributes
22.2.42.2
Elements
22.2.42.3
Used In
22.2.42.4
Examples
22.2.43
GetTable
22.2.43.1
Attributes
22.2.43.2
Elements
22.2.43.3
Used In
22.2.43.4
Examples
22.2.44
GetView
22.2.44.1
Attributes
22.2.44.2
Elements
22.2.44.3
Used In
22.2.44.4
Examples
22.2.45
Filter
22.2.45.1
Attributes
22.2.45.2
Elements
22.2.45.3
Used In
22.2.45.4
Examples
22.2.46
Column
22.2.46.1
Attributes
22.2.46.2
Elements
22.2.46.3
Used In
22.2.46.4
Examples
22.2.47
ComputeColumn
22.2.47.1
Attributes
22.2.47.2
Elements
22.2.47.3
Used In
22.2.47.4
Examples
22.2.48
In
22.2.48.1
Attributes
22.2.48.2
Elements
22.2.48.3
Used In
22.2.49
GroupBy
22.2.49.1
Attributes
22.2.49.2
Elements
22.2.49.3
Used In
22.2.49.4
Examples
22.2.50
By
22.2.50.1
Attributes
22.2.50.2
Elements
22.2.50.3
Used In
22.2.50.4
Examples
22.2.51
AggregateColumn
22.2.51.1
Attributes
22.2.51.2
Elements
22.2.51.3
Used In
22.2.51.4
Examples
22.2.52
Union
22.2.52.1
Attributes
22.2.52.2
Elements
22.2.52.3
Used In
22.2.52.4
Examples
22.2.53
Table
22.2.53.1
Attributes
22.2.53.2
Elements
22.2.53.3
Used In
22.2.53.4
Examples
22.2.54
JoinTables
22.2.54.1
Attributes
22.2.54.2
Elements
22.2.54.3
Used In
22.2.54.4
Examples
22.2.55
Where
22.2.55.1
Attributes
22.2.55.2
Elements
22.2.55.3
Used In
22.2.55.4
Examples
22.2.56
PushDescription
22.2.56.1
Attributes
22.2.56.2
Elements
22.2.56.3
Used In
22.2.56.4
Examples
22.3
Target Collection DTD Elements
22.3.1
TargetCollection
22.3.1.1
Attributes
22.3.1.2
Elements
22.3.1.3
Used In
22.3.1.4
Examples
22.3.2
CollectionLevel
22.3.2.1
Attributes
22.3.2.2
Elements
22.3.2.3
Used In
22.3.2.4
Examples
22.3.3
CollectionItem
22.3.3.1
Attributes
22.3.3.2
Elements
22.3.3.3
Used In
22.3.3.4
Examples
22.3.4
MetricColl
22.3.4.1
Attributes
22.3.4.2
Elements
22.3.4.3
Used In
22.3.4.4
Examples
22.3.5
LimitRows
22.3.5.1
Attributes
22.3.5.2
Elements
22.3.5.3
Used In
22.3.5.4
Examples
22.3.6
ItemProperty
22.3.6.1
Attributes
22.3.6.2
Elements
22.3.6.3
Used In
22.3.6.4
Examples
22.3.7
Filter (for Target Collection)
22.3.7.1
Attributes
22.3.7.2
Elements
22.3.7.3
Used In
22.3.7.4
Examples
22.3.8
Condition
22.3.8.1
Attributes
22.3.8.2
Elements
22.3.8.3
Used In
22.3.8.4
Examples
22.3.9
KeyColumn
22.3.9.1
Attributes
22.3.9.2
Elements
22.3.9.3
Used In
22.3.9.4
Examples
22.3.10
FixitJob
22.3.10.1
Attributes
22.3.10.2
Elements
22.3.10.3
Used In
22.3.10.4
Examples
A
Out-of-Box Associations
B
Plug-in Technical Checklist
B.1
Checking your Plug-in
B.2
Checking Targets
B.3
Checking Customized UIs
B.4
Checking Job Types
B.5
Checking Reports
B.6
Testing your Plug-in
Index
Scripting on this page enhances content navigation, but does not change the content in any way.