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 usageThe 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
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 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 eventString
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 versionstatic 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.
-
-
-
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 propertyvalue
- 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.
-
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.
-
-