C Report Group Configuration Elements

This appendix provides a detailed reference of the report group deployment descriptor elements and includes a brief overview of the descriptor. See Report File Configuration Elements, for a detailed reference of the report file deployment descriptor elements that create individual report files.

This appendix includes the following sections:

C.1 Report Group Configuration Deployment Descriptor

The report group deployment descriptor specifies any number of individual reports to create when reporting is enabled. The coherence.jar/reports directory contains two predefined descriptors. The report-group.xml descriptor is the default descriptor and includes a subset of the predefined reports. The report-all.xml descriptor includes all the predefined reports. Modify the predefined report group deployment descriptors or create new report group deployment descriptors as required. The name and location of which report group deployment descriptor to use at run time is configured in the operational deployment descriptor and is overridden in an operational override file. See Using Oracle Coherence Reporting, for detailed information.

The report group deployment descriptor schema is defined in the coherence-report-group-config.xsd file, which is located in the root of the coherence.jar library and at the following Web URL:

http://xmlns.oracle.com/coherence/coherence-report-group-config/1.0/coherence-report-group-config.xsd

The <report-group> element is the root element of the descriptor and typically includes the XSD reference, the namespace reference, and the location of the coherence-report-group-config.xsd file. For example:

<?xml version='1.0'?>
<report-group xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://xmlns.oracle.com/coherence/coherence-report-group-config"
   xsi:schemaLocation="http://xmlns.oracle.com/coherence/
   coherence-report-group-config coherence-report-group-config.xsd">

Note:

The schema that is located in the coherence.jar library is always used at run time even if the xsi:schemaLocation attribute references the Web URL.
Omit the xsi:schemaLocation attribute to disable schema validation.
When deploying Oracle Coherence into environments where the default character set is EBCDIC rather than ASCII, ensure that the deployment descriptor file is in ASCII format and is deployed into its run-time environment in the binary format.

C.2 Report Group Element Reference

This section contains the following topics:

C.2.1 Report Group Element Index

Table C-1 lists all nonterminal report group deployment descriptor elements.

Table C-1 Report Group Deployment Descriptor Nonterminal Elements

Element	Used in
`init-param`	`init-params`
`init-params`	`report-config`
`report-config`	`report-group`
`report-group`	root element
`report-list`	`report-group`

C.2.2 init-param

Used in: init-params

Description

The init-param element contains an initialization parameter for a report. The parameter consists of either a parameter name or type and its value.

Elements

Table C-2 describes the subelements of the init-param element.

Table C-2 init-param Subelements

Element Required/ Optional Description

Element	Required/ Optional	Description
`param-name`	Optional	Specifies the name of the initialization parameter. This element cannot be used with the `param-type` element.
`param-type`	Optional	Specifies the Java type of the initialization parameter. The following types are supported: `string` – Indicates that the value is a `java.lang.String` `long` – Indicates that the value is a `java.lang.Long` `double` – Indicates that the value is a `java.lang.Double` This element cannot be used with the `para-name` element.
`param-value`	Required	Specifies the value of the initialization parameter. The value is in a format specific to the type of the parameter.

param-name

Optional

Specifies the name of the initialization parameter.

This element cannot be used with the param-type element.

param-type

Optional

Specifies the Java type of the initialization parameter. The following types are supported:

string – Indicates that the value is a java.lang.String
long – Indicates that the value is a java.lang.Long
double – Indicates that the value is a java.lang.Double

This element cannot be used with the para-name element.

param-value

Required

Specifies the value of the initialization parameter. The value is in a format specific to the type of the parameter.

C.2.3 init-params

Used in: report-config

Description

The init-params element contains a list of initialization parameters.

Elements

Table C-3 describes the subelements of the init-params element.

Table C-3 init-params Subelements

Element	Required/ Optional	Description
`init-param`	Optional	Specifies an initialization parameter for a report

C.2.4 report-config

Used in: report-group

Description

The report-config contains the configuration file name and the initialization parameters for the report.

Elements

Table C-4 describes the subelements of the report-config element.

Table C-4 report-config Subelements

Element	Required/ Optional	Description
`location`	Required	Specifies a path to a report configuration descriptor that conforms to the `coherence-report-config.xsd` file. This path is either a file or a URL.
`init-params`	Optional	Specifies a list of initialization parameters

C.2.5 report-group

Used in: root element

Description

The report-group element describes the report list, the frequency, the report parameters, and the output directory for the batch.

Elements

Table C-5 describes the subelements of the report-group element.

Table C-5 report-group Subelements

Element Required/ Optional Description

Element	Required/ Optional	Description
`frequency`	Required	Specifies how often a report batch refreshes. Enter the value in either seconds seconds (`s`) or minutes (`m`). For example, a value of `10s` refreshes the reports every 10 seconds; a value of `5m` refreshes the reports every 5 minutes. Selecting an appropriate frequency is important: if the frequency is too short, the report contains too much data and consumes significant disk space; if the frequency is too long, the report does not contain enough information. In addition, decide on a process for purging and archiving historical information before you enable reporting.
`output-directory`	Optional	The directory path to prepend to the output file names from the report configuration files. The cluster member must have read/write access to this path. The `<output-directory>` element supports an optional `system-property` attribute. The attribute value is a user-defined name that can be used at runtime to override the configured output location. The preconfigured system property override that is used in the predefined report group configuration files is `coherence.reporter.output.directory`.
`report-list`	Required	Specifies a list of report configurations

frequency

Required

Specifies how often a report batch refreshes. Enter the value in either seconds seconds (s) or minutes (m). For example, a value of 10s refreshes the reports every 10 seconds; a value of 5m refreshes the reports every 5 minutes. Selecting an appropriate frequency is important: if the frequency is too short, the report contains too much data and consumes significant disk space; if the frequency is too long, the report does not contain enough information. In addition, decide on a process for purging and archiving historical information before you enable reporting.

output-directory

Optional

The directory path to prepend to the output file names from the report configuration files. The cluster member must have read/write access to this path.

The <output-directory> element supports an optional system-property attribute. The attribute value is a user-defined name that can be used at runtime to override the configured output location.

The preconfigured system property override that is used in the predefined report group configuration files is coherence.reporter.output.directory.

report-list

Required

Specifies a list of report configurations

C.2.6 report-list

Used in: report-group

Description

The report-list element contains the list of reports to include in the batch.

Elements

Table C-6 describes the subelements of the report-list element.

Table C-6 report-list Subelements

Element	Required/ Optional	Description
`report-config`	Required	Specifies the location of the report configuration file and corresponding initialization parameters