org.apache.hadoop.fs.s3a.audit.impl

Class AbstractOperationAuditor

java.lang.Object

org.apache.hadoop.service.AbstractService

org.apache.hadoop.fs.s3a.audit.impl.AbstractOperationAuditor

All Implemented Interfaces:

Closeable, AutoCloseable, OperationAuditor, org.apache.hadoop.fs.statistics.IOStatisticsSource, org.apache.hadoop.fs.store.audit.AuditSpanSource<AuditSpanS3A>, org.apache.hadoop.service.Service

Direct Known Subclasses:

LoggingAuditor, NoopAuditor

public abstract class AbstractOperationAuditor
extends org.apache.hadoop.service.AbstractService
implements OperationAuditor

This is a long-lived service which is created in S3A FS initialize (make it fast!) which provides context for tracking operations made to S3. An IOStatisticsStore is passed in -in production this is expected to be the S3AFileSystem instrumentation, which will have the AUDIT_SPAN_START statistic configured for counting durations.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.service.Service

org.apache.hadoop.service.Service.STATE

Field Summary

Fields

Modifier and Type	Field and Description
static String	BASE Base of IDs is a UUID.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractOperationAuditor(String name) Construct.

Method Summary

Modifier and Type	Method and Description
protected String	createSpanID() Create a span ID.
String	getAuditorId() Get the Auditor ID.
org.apache.hadoop.fs.statistics.impl.IOStatisticsStore	getIOStatistics() Get the IOStatistics Store.
protected OperationAuditorOptions	getOptions() Get the options this auditor was initialized with.
void	init(OperationAuditorOptions opts) Sets the IOStats and then calls init().

Methods inherited from class org.apache.hadoop.service.AbstractService

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, serviceInit, serviceStart, serviceStop, setConfig, start, stop, toString, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.hadoop.fs.s3a.audit.OperationAuditor

checkAccess, getUnbondedSpan

Methods inherited from interface org.apache.hadoop.service.Service

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, registerServiceListener, start, stop, unregisterServiceListener, waitForServiceToStop

Methods inherited from interface org.apache.hadoop.fs.store.audit.AuditSpanSource

createSpan

Field Detail

BASE

public static final String BASE

Base of IDs is a UUID.

Constructor Detail

AbstractOperationAuditor

protected AbstractOperationAuditor(String name)

Construct.

Parameters:

name - name

Method Detail

init

public void init(OperationAuditorOptions opts)

Sets the IOStats and then calls init().

Specified by:

init in interface OperationAuditor

Parameters:

opts - options to initialize with.

getAuditorId

public String getAuditorId()

Description copied from interface: OperationAuditor

Get the Auditor ID.

Specified by:

getAuditorId in interface OperationAuditor

Returns:

ID

getIOStatistics

public org.apache.hadoop.fs.statistics.impl.IOStatisticsStore getIOStatistics()

Get the IOStatistics Store.

Specified by:

getIOStatistics in interface org.apache.hadoop.fs.statistics.IOStatisticsSource

Returns:

the IOStatistics store updated with statistics.

getOptions

protected OperationAuditorOptions getOptions()

Get the options this auditor was initialized with.

Returns:

options.

createSpanID

protected final String createSpanID()

Create a span ID.

Returns:

a unique span ID.