Rhino logs all management operations to two log files in the working directory of each Rhino node (work/logs by default):

  • management.csv, a plain text CSV file

  • encrypted.management.csv, a second, encrypted copy of the logs.

Tip You can use the encrypted version to detect tampering with the plain text copy — decode with the decrypt-management-log script, in the client/bin directory.
Note The management audit logs roll over once they reach 100MB, with an unlimited number of backup files. This logging configuration is currently hard-coded.
Note The format of management audit log can be chosen via system property rhino.audit.log_format. See more detail in system properties.

Below are descriptions of:

and two examples:

What’s in the log file?

Rhino management operations logs include the following fields:

Field Description
 date

A timestamp in the form 2010-05-11 14:55:33.692.

 uniqueID

An identifier used to correlate a set of log lines for a single management operation. All of the log lines from the same operation will have the same uniqueID.

 txID

The transaction ID associated with the operation, used to correlate a set of log lines scoped to a single transactional update. This field only has a value:

  • for operations invoked while a user (externally demarcated) transaction is active; or

  • when logging internal state changes that occur as a result of a declarative configuration import operation.

 opcode

Uniquely identifies the type of operation.

 user

The name of the user invoking the management operation, or unknown1 if there is no authenticated user.

 roles

Any roles associated with the user.

 access

Identifies whether the operation results in a state change of some sort. May be read or write. 2

 client address

The IP address of the client invoking the management operation.

 namespace

The namespace where the management operation invoked. Empty if it is the default namespace.

 MBean name

ObjectName of the MBean invoked.

 operation type

The general type of operation.

 operation name

The name of the invoked method or get/set attribute.

 arguments

The contents of all arguments passed to the management operation. Byte array arguments display converted to a length and a hash.

 duration

How long (in milliseconds) the operation took.

 result

Either ok or failed.3 4

 failure reason

A text string indicating why an operation failed. (Only present for failed results.) 2

Note All management operations except for AUTHENTICATION type operations come in pairs with the first entry indicating the start of an operation, and the second entry indicating success or failure, as well as how long the operation took. Only the result lines make use of the duration, result, and failure reason fields.
Tip For a list of all operations currently recognised by the auditing subsystem, run the getopcodexml command from the command-line console. It will return the complete XML representation of all known management operations.

1 This usually only happens if unauthenticated access has been enabled in Rhino.
2 By default, users with the view permission may only perform read operations.
3 This field is only set for operation results.
4 A failed management operation is one which did not return successfully.

Operation types

The operation type field may contain one of the following values:

Type Result type Description
 AUTHENTICATION

n/a

A successful or failed authentication attempt.

 INVOKE
 INVOKE (RESULT)

An MBean invoke operation.

 GET
 GET (RESULT)

An MBean attribute get operation.

 SET
 SET (RESULT)

An MBean attribute set operation.

 GET-ATTRIBUTES
 GET-ATTRIBUTES (RESULT)

An MBean bulk-attributes GET operation. Log lines with these markers denote a series of related GET requests.

 SET-ATTRIBUTES
 SET-ATTRIBUTES (RESULT)

An MBean bulk-attributes SET operation. Log lines with these markers denote a series of related SET requests.

Managing the audit level

The auditing subsystem provides two console commands to manage what gets logged to the management audit log:

getmanagementauditlevel
  Description
    Returns the current level of management operation auditing.
setmanagementauditlevel <none \| writes \| all>
  Description
    Sets the current level of management operation auditing.
Tip Writes is useful, for example, to avoid receiving excessive messages from an automated management client that continually polls Rhino state using JMX.
Note Rhino always logs changes to the audit level (irrespective of the current level).

Example 1: Resource adaptor deployment and activation

The following example shows management logs from deploying a resource adaptor, creating a resource adaptor entity for it, and activating that resource adaptor entity.

Note The log shows the resource adaptor activated twice in a row, the second operation failing (because the RA was already activated) — see the result and failure fields.
date uniqueID txID opcode user roles access client address MBean name operation type operation name arguments duration result failure reason namespace
 2010-06-08 14:22:06.850
 101:176452077447:22
 admin
  192.168.0.7
 AUTHENTICATION
  ok
 2010-06-08 14:22:35.622
 101:176452077447:29
 19000
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=Deployment
 INVOKE
 install
 [file:/home/alex/simple/simple-ra-ha.jar,
[byte array, length=65164,
  md5sum=96322071e6128333bdee3364a224b48c]
 2010-06-08 14:22:38.961
 101:176452077447:29
 19000
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=Deployment
 INVOKE (RESULT)
 install
 [file:/home/alex/simple/simple-ra-ha.jar,
[byte array, length=65164,
  md5sum=96322071e6128333bdee3364a224b48c]
]
 3339ms
 ok
 2010-06-08 14:22:53.356
 101:176452077447:36
 22014
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE
 getConfigurationProperties
 [ResourceAdaptorID
[name=Simple,vendor=OpenCloud,version=1.0]
]
 2010-06-08 14:22:53.359
 101:176452077447:36
 22014
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE (RESULT)
 getConfigurationProperties
 [ResourceAdaptorID
[name=Simple,vendor=OpenCloud,version=1.0]
]
 3ms
 ok
 2010-06-08 14:22:53.369
 101:176452077447:39
 22016
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE
 createResourceAdaptorEntity
[ResourceAdaptorID
[name=Simple,vendor=OpenCloud,version=1.0],
 simplera,
[(Host:java.lang.String=localhost),
  (Port:java.lang.Integer=14477),
  (slee-vendor:
    com.opencloud.rhino_replicate_activities:
    java.lang.String=none)
 ]
]
 2010-06-08 14:22:53.536
 101:176452077447:39
 22016
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE (RESULT)
 createResourceAdaptorEntity
[ResourceAdaptorID
[name=Simple,vendor=OpenCloud,version=1.0],
 simplera,
[(Host:java.lang.String=localhost),
  (Port:java.lang.Integer=14477),
  (slee-vendor:
    com.opencloud.rhino_replicate_activities:
    java.lang.String=none)
 ]
]
 167ms
 ok
 2010-06-08 14:23:11.987
 101:176452077447:47
 22004
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE
 activateResourceAdaptorEntity
[simplera,[101]]
 2010-06-08 14:23:12.029
 101:176452077447:47
 22004
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE (RESULT)
 activateResourceAdaptorEntity
[simplera,[101]]
 42ms
 ok
 2010-06-08 14:23:30.802
 101:176452077447:52
 22004
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE
 activateResourceAdaptorEntity
[simplera,[101]]
 2010-06-08 14:23:30.820
 101:176452077447:52
 22004
 admin
 admin
 write
 192.168.0.7
 javax.slee.management:
 name=ResourceManagement
 INVOKE (RESULT)
 activateResourceAdaptorEntity
[simplera,[101]]
 18ms
 failed
 simplera not in INACTIVE state on node(s)[101]

Example 2: Bulk GET operation on Licensing MBean

The example below shows a GET-ATTRIBUTES operation called on the Licensing MBean. It includes queries on four separate attributes: LicenseSummary, LicensedFunctions, LicensedVersions, and Licenses. The result of the bulk-attribute query operation are in the last line.

Note Note that the uniqueID field is the same for all lines representing the GET-ATTRIBUTES operation.
date uniqueID txID opcode user roles access client address MBean name operation type operation name arguments duration result failure reason namespace
 2010-05-28 14:07:11.223
 101:175500674962:292
 admin
 admin
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET-ATTRIBUTES
 2010-05-28 14:07:11.223
 101:175500674962:292
 2008
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET
 LicenseSummary
 2010-05-28 14:07:11.223
 101:175500674962:292
 2005
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET
 LicensedFunctions
 2010-05-28 14:07:11.223
 101:175500674962:292
 2006
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET
 LicensedVersions
 2010-05-28 14:07:11.223
 101:175500674962:292
 2004
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET
 Licenses
 2010-05-28 14:07:11.226
 101:175500674962:292
 2008
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET (RESULT)
 LicenseSummary
 3ms
 ok
 2010-05-28 14:07:11.226
 101:175500674962:292
 2005
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET (RESULT)
 LicensedFunctions
 3ms
 ok
 2010-05-28 14:07:11.226
 101:175500674962:292
 2006
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET (RESULT)
 LicensedVersions
 3ms
 ok
 2010-05-28 14:07:11.226
 101:175500674962:292
 2004
 admin
 admin
 read
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET (RESULT)
 Licenses
 3ms
 ok
 2010-05-28 14:07:11.226
 101:175500674962:292
 admin
 admin
 192.168.0.7
 com.opencloud.rhino:
 type=Licensing
 GET-ATTRIBUTES (RESULT)
 3ms
 ok

Note The durations listed for the individual GET (RESULT) lines correspond to the duration of the entire GET-ATTRIBUTES operation and not the individual GET components. In the example above, the entire GET-ATTRIBUTES operation took 3ms.
Previous page Next page
Rhino Version 3.1