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:

  • 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 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.
    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.
    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.
    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 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.
    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 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.
    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.
    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.
    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 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.
    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.
    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.
    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.
    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.
    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 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.
    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.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • Event

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

  • Method Details

    • 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.