reports

Command to initiate the Reports mode and to use its subcommands.

Synopsis

check
cleanup [-t|--t pause_time] [-q|--quiet]
convert [-p partitionID [-n number_of_samples]] [-q|--quiet]
delete -p|--id partitionID [-t|--t pause_time] [-q|--quiet]
disable
enable
info
list
partition -p|--id partitionID [-s|--state] [-k|--hourly] [-d|--daily] [-w|--weekly] [-m|--monthly] [-t|--stats] [-f|--full]
pause -t|--t pause_time
purge [-p partitionID [-n number_of_samples]] [-q|--quiet]
reset -p|--id partitionID [-t|--t pause_time] [-q|--quiet]
reset_stats
rollup [-p|--id partitionID] [-t|--t pausetime] [-q|--quiet]
show
start
stats
stop
urns -p|--id partitionID [-u|--urn urn_name] [-q|--quiet]

Description

The Reports mode is one of a set of modes provided by the Enterprise Manager Ops Center. Use Groups subcommands to perform actions related to the reporting service such as viewing the collection of samples, called partitions, deleting a partition, applying the rollup and cleanup processes to a partition, and reverting the rollup process.

Type the reports command at the command line prompt to enter Reports mode. Type the end to stop the mode and to return to the command line prompt.

Subcommands

check: Checks each partition to determine if a conversion is necessary.
cleanup [-t|--t pause_time] [-q|--quiet]: Start the cleanup process, removing very old samples in a partition.
convert [-p|--id partitionID [-n number_of_samples]] [-q|--quiet]: Converts samples of a partition to a new format.
delete -p|--id partitionID [-t|--t pause_time] [-q|--quiet]: Deletes a specific partition.
disable: Disables automatic rollup and cleanup in a partition.
enable: Enables automatic rollup and cleanup in a partition.
info: Displays detailed information about the rollup and cleanup processes.
list: Displays a list of all partitions managed by the reporting service.
partition -p|--id partitionID [-s|--state] [-k|--hourly] [-d|--daily] [-w|--weekly] [-m|--monthly] [-t|--stats] [-f|--full]: Displays detailed information about a partition, including its state, and the number of daily, hourly, weekly, monthly, or stats samples.
pause -t|--t pause_time: Sets the pause time used for the rollup and cleanup processes.
purge [-p|--id partitionID [-n number_of_samples]] [-q|--quiet]: Purges the old format samples of a partition.
reset -p|--id partitionID [-t|--t pause_time] [-q|--quiet]: Resets a specific partition to revert the effects of a rollup that has been previously applied.
reset_stats: Resets the statistics related to the rollup and cleanup processes.
rollup [-p|--id partitionID] [-t|--t pause_time] [-q|--quiet]: Starts the rollup process, calculating the average of samples in a partition. If no partition is given, the reporting service automatically selects the oldest partition that has not been rolled up already.
show: Displays the current status of the reporting service.
start: Starts the reporting service without restarting the Enterprise Controller.
stats: Displays the statistics related to the rollup and cleanup processes.
stop: Stops the reporting service without stopping the Enterprise Controller.
urns -p|--id partitionID [-u|--urn urn_name] [-q|--quiet]: Displays a list of assets with at least one sample in a specific partition. If no urn name is given, the list of urns that have at least one sample in the partition is shown. This list includes the number of samples for each urn. If a urn name is given, the list of attributes of this urn that have at least one sample is displayed. This list includes the number of samples for each attribute.

Options

The following options are supported by some of the subcommands:

-d|--daily

Display the number of daily samples.

-f|--full

Display all the information about a partition.

-k|--hourly

Display the number of hourly samples.

-m|--monthly

Display the number of monthly samples.

-n| --n

Specifies the number samples.

-p|--id

Specifies a partition by its ID.

-q|--quiet

Avoids displaying warning messages.

-s|--state

Display the state of the partition.

-t

For the partition command, this option displays the number of stats samples.The option can also be invoked as --stats.
For the cleanup, delete, pause, reset, and rollup command, this option is an integer that specifies the pause time in milliseconds.The option can also be invoked as --t.

-u|--urn

Specifies a urn name.

-w|--weekly

Display the number of weekly samples.

Operands

The following operands are supported:

number_of_samples: Integer to specify the samples for the convert or purge subcommands.
partitionID: The identifier of a partition. To obtain a job identifier, use the list command.
pause_time: Integer to specify the pause time in milliseconds.
urn_name: Identifies the asset for which the list of attributes is requested. An urn name is an object name.

Examples

Example 1 Display the number of monthly samples in a partition

EnterpriseController/reports > partition -p 20120514 -m

Example 2 Display a list of assets with at least one sample in a specific partition

EnterpriseController/reports > urns -p 20120514

Example 3 Start the rollup process

EnterpriseController/reports > rollup -p 20120514 -t 10

Example 4 Start the cleanup process

EnterpriseController/reports > cleanup

Example 5 Delete a partition

EnterpriseController/reports > delete -p 20120514