Evaluating JD Edwards EnterpriseOne Performance Monitor Meta-Data

This chapter discusses JD Edwards EnterpriseOne Performance Monitor meta-data definitions and describes how to:

Revise Metric definitions.
Revise Event definitions
Revise Context definitions.
Revise PMU definitions.

Understanding JD Edwards EnterpriseOne Performance Monitor Meta-Data Definitions

JD Edwards EnterpriseOne Performance Monitor uses these meta-data definitions:

Metrics.
Event Definitions.
Contexts.
PMUs.

Metrics

JD Edwards EnterpriseOne Performance Monitor agents send PMUs and events to the monitor. Each PMU and event contains one or more metrics. Each metric has a unique identifier. Metric definitions are the building blocks for creating PMUs and events. PMUs and events comprise up to six numeric values and one string metric value. One metric definition can appear in multiple event and PMU definitions.

Events

Events are not implemented for the 8.95 release of JD Edwards EnterpriseOne Performance Monitor. You can view and add them, however they are not functional.

Events are notifications containing performance metrics that are different from PMUs in that they are not hierarchical, and they do not have durations. JD Edwards EnterpriseOne has defined a set of event types, and each type of event is reported at a specific location in the instrumented code.

Each event has:

Type.
Instance identifier (a unique identifier for a specific event instance).
Timestamp.
Severity.
Metrics (such as CPU usage and memory allocation).

Event definitions group as many as seven metrics to measure the intended performance data. Some events do not have metrics.

Contexts

A context definition applies only to PMU definitions. Contexts provide additional information so that PMU performance data can be displayed and searched more effectively. For example, a context definition enables you to group and sort numeric values, such as an execute count, by form name. Contexts enable the system to assign the data to various elements such as forms, components, service calls, applications, business functions, event rules, and so on. Without contexts, you have only numeric data in no understandable grouping.

PMU metrics contain data that is specific to that PMU. Context values, on the other hand, are common to the entire user request or a specific tier. The system uses contexts to "flatten" a PMU tree. For example, you do not have to navigate up from a SQL PMU to an event rule PMU to see what application generated that SQL statement.

PMUs

A PMU is a unit of measure that reflects the execution of a section of code. The system starts and stops a PMU at specific code locations, and the system may update a PMU anytime between the start and stop times. JD Edwards EnterpriseOne has defined a set of PMU types, and each type of PMU corresponds to the instrumentation at a specific code location, such as a SQL Execute in application or a business function call on the JD Edwards EnterpriseOne server.

Each PMU includes:

PMU Type.
Instance identifier (a unique identifier for a specific PMU instance).
Start time.
Stop time.
Status.
Metrics (such as number of SQL fetches).

A PMU represents a section of code that is bracketed by calls to an internal instrumentation API that signal the start and stop of that logical unit of code.

PMU definitions group as many as seven metrics to measure the intended performance data. Some PMUs do not have metrics.

Forms Used to Evaluate JD Edwards EnterpriseOne Performance Monitor Meta-Data

Form Name	FormID	Navigation	Usage
Metric Definitions - Work With Metric Definitions	W95905A	JD Edwards EnterpriseOne Menus, JD Edwards EnterpriseOne LifecycleTools, System Administration Tools, JD Edwards EnterpriseOne Performance Monitor, Administration, Meta-Data, Metric Definitions	Search for metric definitions.
Metric Definitions - Metric Definition Revisions	W95905C	On Metric Definitions - Work With Metric Definitions, after retrieving metric definitions, select a metric definition you want to revise and click Select.	View and modify metric definitions and opt to display the metric value alone, or with its label.
Metric Definitions - Metric Reference	W95905E	On Metric Definitions - Metric Definition Revisions, click Metric References.	Review metric references.
Context Definitions - Work With Context Definitions	W95905D	JD Edwards EnterpriseOne Menus, JD Edwards EnterpriseOne LifecycleTools, System Administration Tools, JD Edwards EnterpriseOne Performance Monitor, Administration, Meta-Data, Context Definitions	Search for Context Definitions.
Context Definitions - Context Definition Revisions	W95905F	On Context Definitions - Work With Context Definitions, after retrieving context definitions, select a context definition you want to revise and click Select.	View and modify context definitions and access the Context Definitions - Context Reference form.
Context Definitions - Context Reference	W95905E	On the Context Definitions - Context Definition Revisions form, click Context Reference.	View reference data for Context Definitions.
PMU Definitions - Work With PMU Definitions	W95905J	JD Edwards EnterpriseOne Menus, JD Edwards EnterpriseOne LifecycleTools, System Administration Tools, JD Edwards EnterpriseOne Performance Monitor, Administration, Meta-Data, PMU Definitions	Search for and select PMU Definitions.
PMU Definitions - PMU Definition Revisions	W95905G	On PMU Definitions - Work With PMU Definitions, after retrieving PMU definitions, select a PMU definition you want to revise and click Select.	View and revise PMU Definitions.
Event Definitions - Work With Event Definitions	W95905K	JD Edwards EnterpriseOne Menus, JD Edwards EnterpriseOne LifecycleTools, System Administration Tools, JD Edwards EnterpriseOne Performance Monitor, Administration, Meta-Data, Event Definitions	Search for and select Event Definitions.
Event Definitions - Event Definition Revisions	W95905M	On Event Definitions - Work With Event Definitions, after retrieving Event definitions, select an Event definition and click Select.	View and revise Event Definitions.

Revising Metric Definitions

This section discusses the attributes of a metric definition.

Access the Metric Definitions - Metric Definition Revisions form.

Note. Only JD Edwards EnterpriseOne should modify metric definitions. Modifying metric definitions at your site could cause unexpected results.

Metric ID	Identifies Metric meta-data definitions.
Metric Type	Indicates the type of metric meta-data definition (Counter, Gauge, NumID, StrID). Counter: A counter metric is designed to enable sums of values from a specific time range to be calculated. Examples are bytes printed and records written. The values can also be averaged, maximums and minimums can be calculated, and other kinds of statistical calculations can be performed Gauge: A gauge metric is designed to be used instead of a counter when it is not meaningful to calculate sum values that are recorded within a time range. Calculations that are performed on gauge metrics include: average, standard deviation, median, maximum value, and minimum value. For example, the amount of memory that is used on a server is a gauge metric type. If you measure the amount of memory that is used over 20 transactions in a time range, the sum of the memory that is used is not necessarily useful. However, the average, median, and standard deviation provide insight into usage per transaction. Numeric Identifier: A numeric identifier is a numeric value that is used as an identifier, not as a measurement value. Creating sums and averages, or manipulating these values in any arithmetic way is not meaningful. For example, message numbers and error codes are numeric identifier metric types. String: Used with metric definition attributes that need to be represented as text, not a numeric value. Arithmetic operations are not performed on string metric types. For example, descriptive attributes, such as site path, file name, and so on, are string metric types.
Metric Label	Identifies the description for JD Edwards EnterpriseOne Performance Monitor usage. - - - FORM SPECIFIC HELP - - - Displays a more detailed description of the purpose of the metric.
Description	Identifies the description for JD Edwards EnterpriseOne Performance Monitor usage. - - - FORM SPECIFIC HELP - - - Displays a more detailed description of the purpose of the metric.
Metric Multiplier	Identifies the multiplier used for metric definition meta-data.
Display Metric as an Integer	Indicates where metric meta-data definition is an integer or double value. This is a Yes/No flag.
Metric Display	Enables you to determine what appears on the forms displaying a metric. These options are mutually exclusive. Select Display Value to display the actual value. Select Display Label to display the label describing the metric value. If using Display Label select the UDC you wish to use as Display Labels.
Metric References	Calls References (W95905E). Shows all the places this metric is used within PMU and Event Definitions.

Revising Event Definitions

This section discusses the attributes of an Event definition. Events are not implemented for the 8.95 release of JD Edwards EnterpriseOne Performance Monitor. You can view and add them, however they are not functional.

Access the Event Definitions - Event Definition Revisions form.

Event Definition Set	Categorizes meta-data event definitions into a set. Currently, only one definition set exists, and it is reserved for JD Edwards EnterpriseOne development.
Set Description
Event ID	Identifies a particular event you can monitor.
Event Label	Identifies the label for Event meta-data definitions.
Event Description	Describes JD Edwards EnterpriseOne Performance Monitor usage. - - - FORM SPECIFIC HELP - - - Displays a more detailed description of the purpose of the Event.
Additional Label	Identifies the label for PMU additional data.
Standard, Verbose, Debug	Select a filter value to view only the information returned of a specific filter level. Each meta-data definition has a filter level set to one of the following: Standard, verbose, or debug.

Context Tab

Context ID 1–3	Identifies context values 1–3.
Display Content 1–3	Flag to indicate whether or not context value 1 should be displayed when showing PMU data.

Metric Tab

Metric ID 1–7	Identifies meta-data for definitions 1–7 used for giving context to metric values.
Display Metric 1–7	Flag to indicates whether or not context value 1 should be displayed when showing PMU data.

Revising Context Definitions

This section discusses the attributes of a context definition.

Access the Context Definitions - Context Definition Revisions form.

Context Identifier	Identifies Context meta-data definitions.
Context Label	Identifies the context label appears on any form that displays a context to describe the value.
Description	Displays a more detailed description of the purpose of the context.
Context Reference	Calls References (W95905E). Shows all the places this metric is used within PMU and Event Definitions

Revising PMU Definitions

This section describes the attributes of PMU definition.

Access the PMU Definitions - PMU Definition Revisions form.

PMU Definition Set	Categorizes metadata event definitions into a set. Currently, only one definition set exists, and it is reserved for JD Edwards EnterpriseOne development.
Set Description	Describes a definition set.
PMU ID	Identifies a particular PMU that you can monitor.
PMU Label	Identifies the label for PMU additional data.
PMU Description	Describes a PMU metadata definition.
Additional Data Label	Identifies the label for PMU additional data.
Standard, Verbose, Debug	Select a filter value to view only the information returned of a specific filter level. Each meta-data definition has a filter level set to one of the following: Standard, verbose, or debug.
Contexts 1, 2, 3	Identifier to context value 1 through 3.
Display Content 1, 2, 3	Flag to indicate whether or not context value should be displayed when showing PMU data.
Metric ID 1, 2, 3, 4, 5, 6, 7	Identifies metric values 1, 2, 3, 4, 5, 6, 7.
Display Metric ID	Flag to indicate whether or not metric value should be displayed when showing PMU data.