|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ConsumerListener
Listener for data generated by a single DTrace Consumer
.
Method Summary | |
---|---|
void |
consumerStarted(ConsumerEvent e)
Called once when the source Consumer is successfully
started in response to Consumer.go() . |
void |
consumerStopped(ConsumerEvent e)
Called once when the source Consumer is stopped,
indicating that this listener should expect no further events. |
void |
dataDropped(DropEvent e)
Called when traced data is dropped because of inadequate buffer space. |
void |
dataReceived(DataEvent e)
Called whenever a DTrace probe fires (that is, once for each instance of ProbeData generated by DTrace). |
void |
errorEncountered(ErrorEvent e)
Called when an error is encountered in the native DTrace library while tracing probe data. |
void |
intervalBegan(ConsumerEvent e)
Called when the source Consumer wakes up to process its
buffer of traced probe data. |
void |
intervalEnded(ConsumerEvent e)
Called when the source Consumer finishes processing its
buffer of traced probe data and is about to sleep until the next
interval. |
void |
processStateChanged(ProcessEvent e)
Called when the state of a target process changes. |
Method Detail |
---|
void dataReceived(DataEvent e) throws ConsumerException
ProbeData
generated by DTrace). Identifies
the probe and provides data generated by the probe's actions. To
terminate the consumer in the event of unexpected data, throw a
ConsumerException
from this method.
ConsumerException
- if the implementation should terminate
the running consumervoid dataDropped(DropEvent e) throws ConsumerException
ConsumerException
from this method.
ConsumerException
- if the implementation should terminate
the running consumervoid errorEncountered(ErrorEvent e) throws ConsumerException
ConsumerException
from this method.
ConsumerException
- if the implementation should terminate
the running consumervoid processStateChanged(ProcessEvent e) throws ConsumerException
ConsumerException
from this method.
ConsumerException
- if the implementation should terminate
the running consumerConsumer.createProcess(String command)
,
Consumer.grabProcess(int pid)
void consumerStarted(ConsumerEvent e)
Consumer
is successfully
started in response to Consumer.go()
.
consumerStopped(ConsumerEvent e)
void consumerStopped(ConsumerEvent e)
Consumer
is stopped,
indicating that this listener should expect no further events.
Guaranteed to be called whether the consumer was stopped by
request (by calling Consumer.stop()
or Consumer.abort()
), terminated normally as a result of the DTrace
exit()
action (see
exit() in the Special Actions section of the
Actions and Subroutines chapter of the Solaris Dynamic
Tracing Guide) or after the completion of all target
processes, or terminated abnormally because of an exception. It
is necessary to call Consumer.close()
to release any
system resources still held by the stopped consumer.
consumerStarted(ConsumerEvent e)
void intervalBegan(ConsumerEvent e)
Consumer
wakes up to process its
buffer of traced probe data.
intervalEnded(ConsumerEvent e)
void intervalEnded(ConsumerEvent e)
Consumer
finishes processing its
buffer of traced probe data and is about to sleep until the next
interval. The rate of consumption may be controlled with the
switchrate
and aggrate
options (see Consumer.setOption(String option,
String value)
).
intervalBegan(ConsumerEvent e)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |