org.oddjob.jmx.client
Interface LogPollable


public interface LogPollable

An interface for a client side proxy to implement so that a remote object can be polled for log messages.

The idea of being able to poll is that a remote component might be generating thousands of log message which would flood the network if they arrived as notifications. Although polling would miss messages it maintains performance and the time you really want to see messages is when the remote object crashes or hangs.

Polling provides an indication that a remote component is working or what a potential problem might be.

Author:
Rob Gordon

Method Summary
 String consoleId()
          Get the consoleId.
 LogEvent[] retrieveConsoleEvents(long from, int max)
          Poll for console events.
 LogEvent[] retrieveLogEvents(long from, int max)
          Poll for LogEvents.
 String url()
          Get the url for the remote server which we can use to create a unique logger name.
 

Method Detail

url

String url()
Get the url for the remote server which we can use to create a unique logger name.

Returns:

consoleId

String consoleId()
Get the consoleId. The consoleId identifies the console on a remote server. The console will frequently be shared between components in a single JVM and so we don't want to get the same messages on a component by component bases.

Returns:
The consoleId.

retrieveLogEvents

LogEvent[] retrieveLogEvents(long from,
                             int max)
Poll for LogEvents.

Parameters:
from -
max -
Returns:

retrieveConsoleEvents

LogEvent[] retrieveConsoleEvents(long from,
                                 int max)
Poll for console events.

Parameters:
from -
max -
Returns: