|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.hadoop.metrics.spi.AbstractMetricsContext
org.apache.hadoop.metrics2 usage.
@Deprecated @InterfaceAudience.Public @InterfaceStability.Evolving public abstract class AbstractMetricsContext
The main class of the Service Provider Interface. This class should be extended in order to integrate the Metrics API with a specific metrics client library.
This class implements the internal table of metric data, and the timer on which data is to be sent to the metrics system. Subclasses must override the abstractemitRecord method in order to transmit
the data.
| Nested Class Summary | |
|---|---|
static class |
AbstractMetricsContext.MetricMap
Deprecated. |
static class |
AbstractMetricsContext.TagMap
Deprecated. |
| Field Summary |
|---|
| Fields inherited from interface org.apache.hadoop.metrics.MetricsContext |
|---|
DEFAULT_PERIOD |
| Constructor Summary | |
|---|---|
protected |
AbstractMetricsContext()
Deprecated. Creates a new instance of AbstractMetricsContext |
| Method Summary | |
|---|---|
void |
close()
Deprecated. Stops monitoring and frees buffered data, returning this object to its initial state. |
MetricsRecord |
createRecord(String recordName)
Deprecated. Creates a new AbstractMetricsRecord instance with the given recordName. |
protected abstract void |
emitRecord(String contextName,
String recordName,
OutputRecord outRec)
Deprecated. Sends a record to the metrics system. |
protected void |
flush()
Deprecated. Called each period after all records have been emitted, this method does nothing. |
Map<String,Collection<OutputRecord>> |
getAllRecords()
Deprecated. Retrieves all the records managed by this MetricsContext. |
protected String |
getAttribute(String attributeName)
Deprecated. Convenience method for subclasses to access factory attributes. |
protected Map<String,String> |
getAttributeTable(String tableName)
Deprecated. Returns an attribute-value map derived from the factory attributes by finding all factory attributes that begin with contextName.tableName. |
ContextFactory |
getContextFactory()
Deprecated. Returns the factory by which this context was created. |
String |
getContextName()
Deprecated. Returns the context name. |
int |
getPeriod()
Deprecated. Returns the timer period. |
void |
init(String contextName,
ContextFactory factory)
Deprecated. Initializes the context. |
boolean |
isMonitoring()
Deprecated. Returns true if monitoring is currently in progress. |
protected MetricsRecord |
newRecord(String recordName)
Deprecated. Subclasses should override this if they subclass MetricsRecordImpl. |
protected void |
parseAndSetPeriod(String attributeName)
Deprecated. If a period is set in the attribute passed in, override the default with it. |
void |
registerUpdater(Updater updater)
Deprecated. Registers a callback to be called at time intervals determined by the configuration. |
protected void |
remove(MetricsRecordImpl record)
Deprecated. Called by MetricsRecordImpl.remove(). |
protected void |
setPeriod(int period)
Deprecated. Sets the timer period |
void |
startMonitoring()
Deprecated. Starts or restarts monitoring, the emitting of metrics records. |
void |
stopMonitoring()
Deprecated. Stops monitoring. |
void |
unregisterUpdater(Updater updater)
Deprecated. Removes a callback, if it exists. |
protected void |
update(MetricsRecordImpl record)
Deprecated. Called by MetricsRecordImpl.update(). |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
protected AbstractMetricsContext()
| Method Detail |
|---|
public void init(String contextName,
ContextFactory factory)
init in interface MetricsContextcontextName - The given name for this contextfactory - The creator of this contextprotected String getAttribute(String attributeName)
protected Map<String,String> getAttributeTable(String tableName)
public String getContextName()
getContextName in interface MetricsContextpublic ContextFactory getContextFactory()
public void startMonitoring()
throws IOException
startMonitoring in interface MetricsContextIOExceptionpublic void stopMonitoring()
stopMonitoring in interface MetricsContextclose()public boolean isMonitoring()
isMonitoring in interface MetricsContextpublic void close()
close in interface MetricsContextpublic final MetricsRecord createRecord(String recordName)
recordName.
Throws an exception if the metrics implementation is configured with a fixed
set of record names and recordName is not in that set.
createRecord in interface MetricsContextrecordName - the name of the record
MetricsException - if recordName conflicts with configuration dataprotected MetricsRecord newRecord(String recordName)
recordName - the name of the record
public void registerUpdater(Updater updater)
registerUpdater in interface MetricsContextupdater - object to be run periodically; it should update
some metrics recordspublic void unregisterUpdater(Updater updater)
unregisterUpdater in interface MetricsContextupdater - object to be removed from the callback listpublic Map<String,Collection<OutputRecord>> getAllRecords()
getAllRecords in interface MetricsContext
protected abstract void emitRecord(String contextName,
String recordName,
OutputRecord outRec)
throws IOException
IOException
protected void flush()
throws IOException
IOExceptionprotected void update(MetricsRecordImpl record)
protected void remove(MetricsRecordImpl record)
public int getPeriod()
getPeriod in interface MetricsContextprotected void setPeriod(int period)
protected void parseAndSetPeriod(String attributeName)
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||