Package com.yahoo.log.event

Class Event

java.lang.Object

com.yahoo.log.event.Event

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

Collection, Count, CountGroup, Crash, Histogram, Progress, Reloaded, Reloading, Started, Starting, State, Stopped, Stopping, Unknown, Value, ValueGroup

@Deprecated(forRemoval=true,
            since="7")
public abstract class Event
extends Object
implements Serializable

Deprecated, for removal: This API element is subject to removal in a future version.

Only for internal Vespa usage

The Event class is the base class for all VESPA defined events. All specific Event classes extend this abstract class. An event is more or less a type and a set of properties. For convenience we use the logging system to transport Event instances, so the typical use is to serialize events into the payload of log messages.

Note that the static methods started(), stopped() etc are for use with this class so using them in the subclasses isn't really sanctioned. These methods are what the user wants to use for logging events, rather than making events him/herself and stuffing them through the logging API.

Author:

Bjorn Borud

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Event()	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
static void	count(String name, long value)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the count event.
static void	countGroup(String name, String value)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging a set of count events.
static void	crash(String name, int pid, int signal)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the crash event.
String	getName()	Deprecated, for removal: This API element is subject to removal in a future version. Get the name of the event instance.
long	getTime()	Deprecated, for removal: This API element is subject to removal in a future version. Get the timestamp of this event
String	getValue(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Get a property value.
String	getValuePossiblyQuote(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Convenience method which returns a property.
int	getVersion()	Deprecated, for removal: This API element is subject to removal in a future version. Get the event version.
static void	histogram(String name, String value, String representation)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the histogram event.
static Event	parse(String s)	Deprecated, for removal: This API element is subject to removal in a future version. Parse string representation of Event and emit correct Event subtype.
static void	progress(String name, long value, long total)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the progress event.
static void	reloaded(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the reloaded event.
static void	reloading(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the reloading event.
void	setTime(long time)	Deprecated, for removal: This API element is subject to removal in a future version. Set the timestamp of this event.
Event	setValue(String name, String value)	Deprecated, for removal: This API element is subject to removal in a future version. Set a property.
Event	setVersion(int version)	Deprecated, for removal: This API element is subject to removal in a future version. Set event version
static void	started(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the started event.
static void	starting(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the starting event.
static void	state(String name, String value)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the state event.
static void	stopped(String name, int pid, int exitcode)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the stopped event.
static void	stopping(String name, String why)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the stopping event.
String	toString()	Deprecated, for removal: This API element is subject to removal in a future version. This method returns the string representation of the event and must return something that can be parsed by the parse method.
static void	value(String name, double value)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging the value event.
static void	valueGroup(String name, String value)	Deprecated, for removal: This API element is subject to removal in a future version. Static method for logging a set of value events.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Event

protected Event()

Deprecated, for removal: This API element is subject to removal in a future version.

Method Detail

setValue

public Event setValue(String name,
                      String value)

Deprecated, for removal: This API element is subject to removal in a future version.

Set a property.

Parameters:

name - The name of the property

value - The value of the property

getValue

public String getValue(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Get a property value.

setTime

public void setTime(long time)

Deprecated, for removal: This API element is subject to removal in a future version.

Set the timestamp of this event.

getTime

public long getTime()

Deprecated, for removal: This API element is subject to removal in a future version.

Get the timestamp of this event

Returns:

returns the timestamp of this event

setVersion

public Event setVersion(int version)

Deprecated, for removal: This API element is subject to removal in a future version.

Set event version

Parameters:

version - The version of the event.

getVersion

public int getVersion()

Deprecated, for removal: This API element is subject to removal in a future version.

Get the event version.

Returns:

event version

getValuePossiblyQuote

public String getValuePossiblyQuote(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Convenience method which returns a property. If the property contains whitespace the property will be enclosed in quotes. FIXME: quotes inside the value are not quoted

getName

public String getName()

Deprecated, for removal: This API element is subject to removal in a future version.

Get the name of the event instance.

Returns:

the name of the event instance.

toString

public String toString()

Deprecated, for removal: This API element is subject to removal in a future version.

This method returns the string representation of the event and must return something that can be parsed by the parse method.

Overrides:

toString in class Object

parse

public static Event parse(String s)
                   throws MalformedEventException

Deprecated, for removal: This API element is subject to removal in a future version.

Parse string representation of Event and emit correct Event subtype.

Parameters:

s - A string containing an event

Returns:

Event represented by s.

Throws:

MalformedEventException - if unable to deciper Event from string.

starting

public static final void starting(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the starting event.

started

public static final void started(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the started event.

stopping

public static final void stopping(String name,
                                  String why)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the stopping event.

stopped

public static final void stopped(String name,
                                 int pid,
                                 int exitcode)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the stopped event.

reloading

public static final void reloading(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the reloading event.

reloaded

public static final void reloaded(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the reloaded event.

count

public static final void count(String name,
                               long value)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the count event.

value

public static final void value(String name,
                               double value)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the value event.

histogram

public static final void histogram(String name,
                                   String value,
                                   String representation)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the histogram event.

valueGroup

public static final void valueGroup(String name,
                                    String value)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging a set of value events.

countGroup

public static final void countGroup(String name,
                                    String value)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging a set of count events.

progress

public static final void progress(String name,
                                  long value,
                                  long total)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the progress event.

state

public static final void state(String name,
                               String value)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the state event.

crash

public static final void crash(String name,
                               int pid,
                               int signal)

Deprecated, for removal: This API element is subject to removal in a future version.

Static method for logging the crash event.