(14)YARN Timeline Server

系统管理员 2022-09-30 12:55 149阅读 0赞

# The YARN Timeline Server #

*  [Overview][]
    
     *  [Introduction][]
     *  [Current Status][]
     *  [Timeline Structure][]
 *  [Deployment][]
    
     *  [Configurations][]
     *  [Running the Timeline Server][]
     *  [Accessing generic-data via command-line][]
 *  [Publishing of application specific data][]
 *  [Timeline Server REST API][]
 *  [Generic Data REST APIs][]

## Overview ##

### Introduction ###

The Storage and retrieval of application’s current and historic information in a generic fashion is addressed in YARN through the Timeline Server. It has two responsibilities:

#### Persisting Application Specific Information ####

The collection and retrieval of information completely specific to an application or framework. For example, the Hadoop MapReduce framework can include pieces of information like number of map tasks, reduce tasks, counters…etc. Application developers can publish the specific information to the Timeline server via TimelineClient in the Application Master and/or the application’s containers.

This information is then queryable via REST APIs for rendering by application/framework specific UIs.

#### Persisting Generic Information about Completed Applications ####

Previously this was supported purely for MapReduce jobs by the Application History Server. With the introduction of the timeline server, the Application History Server becomes just one use of the Timeline Server.

Generic information includes application level data such as

*  queue-name,
 *  user information and the like set in the ApplicationSubmissionContext,
 *  a list of application-attempts that ran for an application
 *  information about each application-attempt
 *  the list of containers run under each application-attempt
 *  information about each container.

Generic data is published by the YARN Resource Manager to the timeline store and used by its web-UI to display information about completed applications.

### Current Status and Future Plans ###

Current status

1.  The core functionality of the timeline server has been completed.
2.  It works in both secure and non secure clusters.
3.  The generic history service is built on the timeline store.
4.  The history can be stored in memory or in a leveldb database store; the latter ensures the history is preserved over Timeline Server restarts.
5.  The ability to install framework specific UIs in YARN is not supported.
6.  Application specific information is only available via RESTful APIs using JSON type content.
7.  The “Timeline Server v1” REST API has been declared one of the REST APIs whose compatibility will be maintained in future releases.
8.  The single-server implementation of the Timeline Server places a limit on the scalability of the service; it also prevents the service being High-Availability component of the YARN infrastructure.

Future Plans

1.  Future releases will introduce a next generation timeline service which is scalable and reliable, “Timeline Server v2”.
2.  The expanded features of this service *may not* be available to applications using the Timeline Server v1 REST API. That includes extended data structures as well as the ability of the client to failover between Timeline Server instances.

### Timeline Structure ###

![Timeline Structure][Timeline Structure 1]

#### Timeline Domain ####

The Timeline Domain offers a namespace for Timeline server allowing users to host multiple entities, isolating them from other users and applications. Timeline server Security is defined at this level.

A “Domain” primarily stores owner info, read and& write ACL information, created and modified time stamp information. Each Domain is identified by an ID which must be unique across all users in the YARN cluster.

#### Timeline Entity ####

A Timeline Entity contains the the meta information of a conceptual entity and its related events.

The entity can be an application, an application attempt, a container or any user-defined object.

It contains **Primary filters** which will be used to index the entities in the Timeline Store. Accordingly, users/applications should carefully choose the information they want to store as the primary filters.

The remaining data can be stored as unindexed information. Each Entity is uniquely identified by an EntityId and EntityType.

#### Timeline Events ####

A Timeline Event describes an event that is related to a specific Timeline Entity of an application.

Users are free to define what an event means —such as starting an application, getting allocated a container, an operation failures or other information considered relevant to users and cluster operators.

## Deployment ##

### Configurations ###

#### Basic Configuration ####

#### Timeline store and state store configuration ####

<table style="padding:0px; width:1108px; margin-left:-2px; margin-right:-2px; font-size:10px"> 
 <thead> 
  <tr style="background-color:rgb(221,221,221)"> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Configuration Property</th> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.store-class</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Store class name for timeline store. Defaults to&nbsp;org.apache.hadoop.yarn.server.timeline.LeveldbTimelineStore.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-timeline-store.path</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Store file name for leveldb timeline store. Defaults to&nbsp;${hadoop.tmp.dir}/yarn/timeline.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-timeline-store.ttl-interval-ms</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Length of time to wait between deletion cycles of leveldb timeline store in milliseconds. Defaults to&nbsp;300000.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-timeline-store.read-cache-size</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Size of read cache for uncompressed blocks for leveldb timeline store in bytes. Defaults to&nbsp;104857600.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-timeline-store.start-time-read-cache-size</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Size of cache for recently read entity start times for leveldb timeline store in number of entities. Defaults to&nbsp;10000.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-timeline-store.start-time-write-cache-size</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Size of cache for recently written entity start times for leveldb timeline store in number of entities. Defaults to&nbsp;10000.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.recovery.enabled</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Defaults to&nbsp;false.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.state-store-class</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Store class name for timeline state store. Defaults to&nbsp;org.apache.hadoop.yarn.server.timeline.recovery.LeveldbTimelineStateStore.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.leveldb-state-store.path</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Store file name for leveldb timeline state store.</td> 
  </tr> 
 </tbody> 
</table>

#### Web and RPC Configuration ####

<table style="padding:0px; width:1108px; margin-left:-2px; margin-right:-2px; font-size:10px"> 
 <thead> 
  <tr style="background-color:rgb(221,221,221)"> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Configuration Property</th> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.hostname</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The hostname of the Timeline service web application. Defaults to&nbsp;0.0.0.0</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.address</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Address for the Timeline server to start the RPC server. Defaults to&nbsp;${yarn.timeline-service.hostname}:10200.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.webapp.address</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The http address of the Timeline service web application. Defaults to&nbsp;${yarn.timeline-service.hostname}:8188.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.webapp.https.address</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The https address of the Timeline service web application. Defaults to&nbsp;${yarn.timeline-service.hostname}:8190.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.bind-host</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The actual address the server will bind to. If this optional address is set, the RPC and webapp servers will bind to this address and the port specified in&nbsp;yarn.timeline-service.address&nbsp;and&nbsp;yarn.timeline-service.webapp.address, respectively. This is most useful for making the service listen on all interfaces by setting to&nbsp;0.0.0.0.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-cross-origin.enabled</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Enables cross-origin support (CORS) for web services where cross-origin web response headers are needed. For example, javascript making a web services request to the timeline server. Defaults to&nbsp;false.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-cross-origin.allowed-origins</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Comma separated list of origins that are allowed for web services needing cross-origin (CORS) support. Wildcards&nbsp;(*)&nbsp;and patterns allowed. Defaults to&nbsp;*.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-cross-origin.allowed-methods</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Comma separated list of methods that are allowed for web services needing cross-origin (CORS) support. Defaults to&nbsp;GET,POST,HEAD.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-cross-origin.allowed-headers</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Comma separated list of headers that are allowed for web services needing cross-origin (CORS) support. Defaults to&nbsp;X-Requested-With,Content-Type,Accept,Origin.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-cross-origin.max-age</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The number of seconds a pre-flighted request can be cached for web services needing cross-origin (CORS) support. Defaults to&nbsp;1800.</td> 
  </tr> 
 </tbody> 
</table>

Note that the selection between the HTTP and HTTPS binding is made in the TimelineClient based upon the value of the YARN-wide configuration option yarn.http.policy; the HTTPS endpoint will be selected if this policy is either of HTTPS\_ONLY or HTTP\_AND\_HTTPS.

#### Advanced Server-side configuration ####

#### UI Hosting Configuration ####

The timeline service can host multiple UIs if enabled. The service can support both static web sites hosted in a directory or war files bundled. The web UI is then hosted on the timeline service HTTP port under the path configured.

#### Security Configuration ####

Security can be enabled by setting yarn.timeline-service.http-authentication.type to kerberos, after which the following configuration options are available:

<table style="padding:0px; width:1108px; margin-left:-2px; margin-right:-2px; font-size:10px"> 
 <thead> 
  <tr style="background-color:rgb(221,221,221)"> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Configuration Property</th> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-authentication.type</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Defines authentication used for the timeline server HTTP endpoint. Supported values are:&nbsp;simple&nbsp;/&nbsp;kerberos&nbsp;/ #AUTHENTICATION_HANDLER_CLASSNAME#. Defaults to&nbsp;simple.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.http-authentication.simple.anonymous.allowed</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Indicates if anonymous requests are allowed by the timeline server when using ‘simple’ authentication. Defaults to&nbsp;true.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.principal</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The Kerberos principal for the timeline server.</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.keytab</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The Kerberos keytab for the timeline server. Defaults on Unix to to&nbsp;/etc/krb5.keytab.</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.delegation.key.update-interval</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Defaults to&nbsp;86400000&nbsp;(1 day).</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.delegation.token.renew-interval</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Defaults to&nbsp;86400000&nbsp;(1 day).</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.delegation.token.max-lifetime</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Defaults to&nbsp;604800000&nbsp;(7 days).</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> yarn.timeline-service.client.best-effort</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Should the failure to obtain a delegation token be considered an application failure (option = false), or should the client attempt to continue to publish information without it (option=true). Default:&nbsp;false</td> 
  </tr> 
 </tbody> 
</table>

#### Enabling the timeline service and the generic history service ####

Following are the basic configuration to start Timeline server.

<property>
      <description>Indicate to clients whether Timeline service is enabled or not.
      If enabled, the TimelineClient library used by end-users will post entities
      and events to the Timeline server.</description>
      <name>yarn.timeline-service.enabled</name>
      <value>true</value>
    </property>
    
    <property>
      <description>The setting that controls whether yarn system metrics is
      published on the timeline server or not by RM.</description>
      <name>yarn.resourcemanager.system-metrics-publisher.enabled</name>
      <value>true</value>
    </property>
    
    <property>
      <description>Indicate to clients whether to query generic application
      data from timeline history-service or not. If not enabled then application
      data is queried only from Resource Manager.</description>
      <name>yarn.timeline-service.generic-application-history.enabled</name>
      <value>true</value>
    </property>

### Running the Timeline Server ###

Assuming all the aforementioned configurations are set properly admins can start the Timeline server/history service with the following command:

yarn timelineserver

To start the Timeline server / history service as a daemon, the command is

$HADOOP_YARN_HOME/sbin/yarn-daemon.sh start timelineserver

### Accessing generic-data via command-line ###

Users can access applications’ generic historic data via the command line below

$ yarn application -status <Application ID>
    $ yarn applicationattempt -list <Application ID>
    $ yarn applicationattempt -status <Application Attempt ID>
    $ yarn container -list <Application Attempt ID>
    $ yarn container -status <Container ID>

Note that the same commands are usable to obtain the corresponding information about running applications.

### Publishing application specific data ###

Developers can define what information they want to record for their applications by constructing TimelineEntity and TimelineEvent objects then publishing the entities and events to the Timeline Server via the TimelineClient API.

Here is an example:

// Create and start the Timeline client
    TimelineClient client = TimelineClient.createTimelineClient();
    client.init(conf);
    client.start();
    
    try {
      TimelineDomain myDomain = new TimelineDomain();
      myDomain.setID("MyDomain");
      // Compose other Domain info ....
    
      client.putDomain(myDomain);
    
      TimelineEntity myEntity = new TimelineEntity();
      myEntity.setDomainId(myDomain.getId());
      myEntity.setEntityType("APPLICATION");
      myEntity.setEntityID("MyApp1")
      // Compose other entity info
    
      TimelinePutResponse response = client.putEntities(entity);
    
      TimelineEvent event = new TimelineEvent();
      event.setEventType("APP_FINISHED");
      event.setTimestamp(System.currentTimeMillis());
      event.addEventInfo("Exit Status", "SUCCESS");
      // Compose other Event info ....
    
      myEntity.addEvent(event);
      TimelinePutResponse response = timelineClient.putEntities(entity);
    
    } catch (IOException e) {
      // Handle the exception
    } catch (RuntimeException e) {
      // In Hadoop 2.6, if attempts submit information to the Timeline Server fail more than the retry limit,
      // a RuntimeException will be raised. This may change in future releases, being
      // replaced with a IOException that is (or wraps) that which triggered retry failures.
    } catch (YarnException e) {
      // Handle the exception
    } finally {
      // Stop the Timeline client
      client.stop();
    }

1.  Publishing of data to Timeline Server is a synchronous operation; the call will not return until successful.
2.  The TimelineClient implementation class is a subclass of the YARN Service API; it can be placed under a CompositeService to ease its lifecycle management.
3.  The result of a putEntities() call is a TimelinePutResponse object. This contains a (hopefully empty) list of those timeline entities reject by the timeline server, along with an error code indicating the cause of each failure.

In Hadoop 2.6 and 2.7, the error codes are:

Further error codes may be defined in future.

**Note** : Following are the points which need to be observed when updating a entity.

*  Domain ID should not be modified for already existing entity.
 *  After a modification of a Primary filter value, the new value will be appended to the old value; the original value will not be replaced.
 *  It’s advisable to have same primary filters for all updates on entity. Any on modification of a primary filter by in an update will result in queries with updated primary filter to not fetching the information before the update

# Generic Data Web UI #

Users can access the generic historic information of applications via web UI:

http(s)://<timeline server http(s) address:port>/applicationhistory

## Timeline Server REST API V1 ##

Querying the timeline server is currently only supported via REST API calls; there is no API client implemented in the YARN libraries. In Java, the Jersey client is effective at querying the server, even in secure mode (provided the caller has the appropriate Kerberos tokens or keytab).

The v1 REST API is implemented at under the path, /ws/v1/timeline/ on the Timeline Server web service.

Here is a non-normative description of the API.

### Root path ###

GET /ws/v1/timeline/

Returns a JSON object describing the server instance.

{"About":"Timeline API"}

## Domains /ws/v1/timeline/domain ##

### Domain summary information /ws/v1/timeline/domain ###

GET /ws/v1/timeline/domain?owner=$OWNER

Returns a list of domains belonging to a specific user, in the JSON-marshalled TimelineDomains data structure.

The owner MUST be set on a GET which is not authenticated.

On an authenticated request, the owner defaults to the caller.

PUT /ws/v1/timeline/domain

A PUT of a serialized TimelineDomain structure to this path will add the domain to the list of domains owned by the specified/current user. A successful operation returns status code of 200 and a TimelinePutResponse containing no errors.

### Specific information about a Domain /ws/v1/timeline/domain/\{domainId\} ###

Returns a JSON-marshalled TimelineDomain structure describing a domain.

If the domain is not found, then an HTTP 404 response is returned.

### POST new domain /ws/v1/timeline/domain ###

Creates a new timeline domain, or overrides an existing one.

When attempting to create a new domain, the ID in the submission MUST be unique across all domains in the cluster.

When attempting to update an existing domain, the ID of that domain must be set. The submitter must have the appropriate permissions to update the domain.

submission: TimelineDomain

response: TimelinePutResponse

### List domains of a user: GET /ws/v1/timeline/domain ###

Retrieves a list of all domains of a user.

If an owner is specified, that owner name overrides that of the caller.

GET http://localhost:8188/ws/v1/timeline/domain?owner=alice
    
    {
    "domains":
      [
        {
        "id":"DS_DOMAIN_2",
        "owner":"alice",
        "readers":"peter",
        "writers":"john",
        "createdtime":1430425000337,
        "modifiedtime":1430425000337
        },
        {
        "id":"DS_DOMAIN_1",
        "owner":"alice",
        "readers":"bar",
        "writers":"foo",
        "createdtime":1430424955963,
        "modifiedtime":1430424955963
        }
        ,
        {"id":"DEFAULT",
        "description":"System Default Domain",
        "owner":"alice",
        "readers":"*",
        "writers":"*",
        "createdtime":1430424022699,
        "modifiedtime":1430424022699
        }
      ]
    }

response: TimelineDomains

If the user lacks the permission to list the domains of the specified owner, an TimelineDomains response with no domain listings is returned.

#### Retrieve details of a specific domain: GET /ws/v1/timeline/domain/\{domainId\} ####

Retrieves the details of a single domain

GET http://localhost:8188/ws/v1/timeline/domain/DS_DOMAIN_1

Response: TimelineDomain

{
      "id":"DS_DOMAIN_1",
      "owner":"zshen",
      "readers":"bar",
      "writers":"foo",
      "createdtime":1430424955963,
      "modifiedtime":1430424955963
    }

If the user lacks the permission to query the details of that domain, a 404, not found exception is returned —the same response which is returned if there is no entry with that ID.

## Posting Timeline Entities ##

With the Posting Entities API, you can post the entities and events, which contain the per-framework information you want to record, to the timeline server.

### URI: ###

http(s)://<timeline server http(s) address:port>/ws/v1/timeline

### HTTP Operations Supported: ###

POST

### Query Parameters Supported: ###

None

### response: TimelinePutResponse ###

### Request Examples: ###

#### JSON request ####

HTTP Request:

POST http://<timeline server http address:port>/ws/v1/timeline

Request Header:

POST /ws/v1/timeline HTTP/1.1
    Accept: application/json
    Content-Type: application/json
    Transfer-Encoding: chunked

Request Body:

{
      "entities" : [ {
        "entity" : "entity id 0",
        "entitytype" : "entity type 0",
        "relatedentities" : {
          "test ref type 2" : [ "test ref id 2" ],
          "test ref type 1" : [ "test ref id 1" ]
        },
        "events" : [ {
          "timestamp" : 1395818851590,
          "eventtype" : "event type 0",
          "eventinfo" : {
            "key2" : "val2",
            "key1" : "val1"
          }
        }, {
          "timestamp" : 1395818851590,
          "eventtype" : "event type 1",
          "eventinfo" : {
            "key2" : "val2",
            "key1" : "val1"
          }
        } ],
        "primaryfilters" : {
          "pkey2" : [ "pval2" ],
          "pkey1" : [ "pval1" ]
        },
        "otherinfo" : {
          "okey2" : "oval2",
          "okey1" : "oval1"
        },
        "starttime" : 1395818851588
      }, {
        "entity" : "entity id 1",
        "entitytype" : "entity type 0",
        "relatedentities" : {
          "test ref type 2" : [ "test ref id 2" ],
          "test ref type 1" : [ "test ref id 1" ]
        },
        "events" : [ {
          "timestamp" : 1395818851590,
          "eventtype" : "event type 0",
          "eventinfo" : {
            "key2" : "val2",
            "key1" : "val1"
          }
        }, {
          "timestamp" : 1395818851590,
          "eventtype" : "event type 1",
          "eventinfo" : {
            "key2" : "val2",
            "key1" : "val1"
          }
        } ],
        "primaryfilters" : {
          "pkey2" : [ "pval2" ],
          "pkey1" : [ "pval1" ]
        },
        "otherinfo" : {
          "okey2" : "oval2",
          "okey1" : "oval1"
        },
        "starttime" : 1395818851590
      } ]
    }

Required fields

Entity: type and id. starttime is required unless the entity contains one or more event). Event: type and timestamp.

## Timeline Entity List ##

With the Timeline Entity List API, you can retrieve a list of entity object, sorted by the starting timestamp for the entity, descending. The starting timestamp of an entity can be a timestamp specified by the your application. If it is not explicitly specified, it will be chosen by the store to be the earliest timestamp of the events received in the first post for the entity.

### URI: ###

Use the following URI to obtain all the entity objects of a given entityType.

http(s)://<timeline server http(s) address:port>/ws/v1/timeline/{entityType}

### HTTP Operations Supported: ###

GET  http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT

### Query Parameters Supported: ###

1.  limit - A limit on the number of entities to return. If null, defaults to 100.
2.  windowStart - The earliest start timestamp to retrieve (exclusive). If null, defaults to retrieving all entities until the limit is reached.
3.  windowEnd - The latest start timestamp to retrieve (inclusive). If null, defaults to the max value of Long.
4.  fromId - If fromId is not null, retrieve entities earlier than and including the specified ID. If no start time is found for the specified ID, an empty list of entities will be returned. The windowEnd parameter will take precedence if the start time of this entity falls later than windowEnd.
5.  fromTs - If fromTs is not null, ignore entities that were inserted into the store after the given timestamp. The entity’s insert timestamp used for this comparison is the store’s system time when the first put for the entity was received (not the entity’s start time).
6.  primaryFilter - Retrieves only entities that have the specified primary filter. If null, retrieves all entities. This is an indexed retrieval, and no entities that do not match the filter are scanned.
7.  secondaryFilters - Retrieves only entities that have exact matches for all the specified filters in their primary filters or other info. This is not an indexed retrieval, so all entities are scanned but only those matching the filters are returned.
8.  fields - Specifies which fields of the entity object to retrieve: EVENTS, RELATED\_ENTITIES, PRIMARY\_FILTERS, OTHER\_INFO, LAST\_EVENT\_ONLY. If the set of fields contains LAST\_EVENT\_ONLY and not EVENTS, the most recent event for each entity is retrieved. If null, retrieves all fields.

Note that the value of the key/value pair for primaryFilter and secondaryFilters parameters can be of different data types, and matching is data type sensitive. Users need to format the value properly. For example, 123 and "123" means an integer and a string respectively. If the entity has a string "123" for primaryFilter, but the parameter is set to the integer 123, the entity will not be matched. Similarly, true means a boolean while "true" means a string. In general, the value will be casted as a certain Java type in consistent with jackson library parsing a JSON clip.

### Elements of the entities (Timeline Entity List) Object ###

When you make a request for the list of timeline entities, the information will be returned as a collection of container objects. See also Timeline Entity for syntax of the timeline entity object.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://<timeline server http address:port>/ws/v1/timeline/{entity-type}

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "entities":[
      {
      "entitytype":"DS_APP_ATTEMPT",
      "entity":"appattempt_1430424020775_0004_000001",
      "events":[
        {
        "timestamp":1430425008796,
        "eventtype":"DS_APP_ATTEMPT_END",
        "eventinfo": { }
        }
        {
        "timestamp":1430425004161,
        "eventtype":"DS_APP_ATTEMPT_START",
        "eventinfo": { }
        }
      ]
      "starttime":1430425004161,
      "domain":"DS_DOMAIN_2",
      "relatedentities": { },
      "primaryfilters":
        {
        "user":["zshen"]
        },
      "otherinfo": { }
      }
      {
      "entitytype":"DS_APP_ATTEMPT",
      "entity":"appattempt_1430424020775_0003_000001",
      "starttime":1430424959169,
      "domain":"DS_DOMAIN_1",
      "events":[
        {
        "timestamp":1430424963836,
        "eventinfo": { }
         }
        {
        "timestamp":1430424959169,
        "eventinfo": { }
        }
       ]
      "relatedentities": { },
      "primaryfilters": {
        "user":["zshen"]
       },
      "otherinfo": { }
       }
      ]
    }

## Timeline Entity ##

With the Timeline Entity API, you can retrieve the entity information for a given entity identifier.

### URI: ###

Use the following URI to obtain the entity object identified by the entityType value and the entityId value.

http(s)://<timeline server http(s) address:port>/ws/v1/timeline/{entityType}/{entityId}

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

1.  fields - Specifies which fields of the entity object to retrieve: EVENTS, RELATED\_ENTITIES, PRIMARY\_FILTERS, OTHER\_INFO, LAST\_EVENT\_ONLY. If the set of fields contains LAST\_EVENT\_ONLY and not EVENTS, the most recent event for each entity is retrieved. If null, retrieves all fields.

### Elements of the entity (Timeline Entity) Object: ###

See also Timeline Event List for syntax of the timeline event object. Note that value of primaryfilters and otherinfo is an Object instead of a String.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://<timeline server http address:port>/ws/v1/timeline/{entity-type}/{entity-id}

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/appattempt_1430424020775_0003_000001
    
    {
      "events":[
        {
        "timestamp":1430424959169,
        "eventtype":"DS_APP_ATTEMPT_START",
        "eventinfo":  {}}],
        "entitytype":"DS_APP_ATTEMPT",
        "entity":"appattempt_1430424020775_0003_000001",
        "starttime":1430424959169,
        "domain":"DS_DOMAIN_1",
        "relatedentities":  {},
        "primaryfilters":  {
            "user":["zshen"]
            },
        "otherinfo":  {}
        }
      ]
    }

## Timeline Event List ##

With the Timeline Events API, you can retrieve the event objects for a list of entities all of the same entity type. The events for each entity are sorted in order of their timestamps, descending.

### URI: ###

Use the following URI to obtain the event objects of the given entityType.

http(s)://<timeline server http(s) address:port>/ws/v1/timeline/{entityType}/events

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

1.  entityIds - The entity IDs to retrieve events for.
2.  limit - A limit on the number of events to return for each entity. If null, defaults to 100 events per entity.
3.  windowStart - If not null, retrieves only events later than the given time (exclusive)
4.  windowEnd - If not null, retrieves only events earlier than the given time (inclusive)
5.  eventTypes - Restricts the events returned to the given types. If null, events of all types will be returned.

### Elements of the events (Timeline Entity List) Object ###

When you make a request for the list of timeline events, the information will be returned as a collection of event objects.

Below is the elements of a single event object. Note that value of eventinfo and otherinfo is an Object instead of a String.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://<timeline server http address:port>/ws/v1/timeline/entity%20type%200/events

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/events?entityId=appattempt_1430424020775_0003_000001
    
    
    {
    "events": [
      {
      "entity":"appattempt_1430424020775_0003_000001",
      "entitytype":"DS_APP_ATTEMPT"}
      "events":[
        {
        "timestamp":1430424963836,
        "eventtype":"DS_APP_ATTEMPT_END",
        "eventinfo":{}},
        {
        "timestamp":1430424959169,
        "eventtype":"DS_APP_ATTEMPT_START",
        "eventinfo":{}}
        ],
       }
      ]
    }

# Generic Data REST APIs #

Users can access the generic historic information of applications via REST APIs.

## Application List ##

With the Application List API, you can obtain a collection of resources, each of which represents an application. When you run a GET operation on this resource, you obtain a collection of application objects.

### URI: ###

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

1.  states - applications matching the given application states, specified as a comma-separated list
2.  finalStatus - the final status of the application - reported by the application itself
3.  user - user name
4.  queue - queue name
5.  limit - total number of app objects to be returned
6.  startedTimeBegin - applications with start time beginning with this time, specified in ms since epoch
7.  startedTimeEnd - applications with start time ending with this time, specified in ms since epoch
8.  finishedTimeBegin - applications with finish time beginning with this time, specified in ms since epoch
9.  finishedTimeEnd - applications with finish time ending with this time, specified in ms since epoch
10. applicationTypes - applications matching the given application types, specified as a comma-separated list

### Elements of the apps (Application List) Object ###

When you make a request for the list of applications, the information will be returned as a collection of application objects. See also Application for syntax of the application object.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://<timeline server http address:port>/ws/v1/applicationhistory/apps

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "app":
      [
          {
          "appId":"application_1430424020775_0004",
          "currentAppAttemptId":"appattempt_1430424020775_0004_000001",
          "user":"zshen",
          "name":"DistributedShell",
          "queue":"default",
          "type":"YARN",
          "host":"d-69-91-129-173.dhcp4.washington.edu/69.91.129.173",
          "rpcPort":-1,
          "appState":"FINISHED",
          "progress":100.0,
          "diagnosticsInfo":"",
          "originalTrackingUrl":"N/A",
          "trackingUrl":"http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0004/",
          "finalAppStatus":"SUCCEEDED",
          "submittedTime":1430425001004,
          "startedTime":1430425001004,
          "finishedTime":1430425008861,
          "elapsedTime":7857},
          {
          "appId":"application_1430424020775_0003",
          "currentAppAttemptId":"appattempt_1430424020775_0003_000001",
          "user":"zshen",
          "name":"DistributedShell",
          "queue":"default",
          "type":"YARN",
          "host":"d-69-91-129-173.dhcp4.washington.edu/69.91.129.173",
          "rpcPort":-1,
          "appState":"FINISHED",
          "progress":100.0,
          "diagnosticsInfo":"",
          "originalTrackingUrl":"N/A",
          "trackingUrl":"http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0003/",
          "finalAppStatus":"SUCCEEDED",
          "submittedTime":1430424956650,
          "startedTime":1430424956650,
          "finishedTime":1430424963907,
          "elapsedTime":7257},
          {
          "appId":"application_1430424020775_0002",
          "currentAppAttemptId":"appattempt_1430424020775_0002_000001",
          "user":"zshen",
          "name":"DistributedShell",
          "queue":"default",
          "type":"YARN",
          "host":"d-69-91-129-173.dhcp4.washington.edu/69.91.129.173",
          "rpcPort":-1,
          "appState":"FINISHED",
          "progress":100.0,
          "diagnosticsInfo":"",
          "originalTrackingUrl":"N/A",
          "trackingUrl":"http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0002/",
          "finalAppStatus":"SUCCEEDED",
          "submittedTime":1430424769395,
          "startedTime":1430424769395,
          "finishedTime":1430424776594,
          "elapsedTime":7199
          }
      ]
    }

#### XML response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 1710

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <apps>
      <app>
        <appId>application_1430424020775_0004</appId>
        <currentAppAttemptId>appattempt_1430424020775_0004_000001</currentAppAttemptId>
        <user>zshen</user>
        <name>DistributedShell</name>
        <queue>default</queue>
        <type>YARN</type>
        <host>d-69-91-129-173.dhcp4.washington.edu/69.91.129.173</host>
        <rpcPort>-1</rpcPort>
        <appState>FINISHED</appState>
        <progress>100.0</progress>
        <diagnosticsInfo></diagnosticsInfo>
        <originalTrackingUrl>N/A</originalTrackingUrl>
        <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0004/</trackingUrl>
        <finalAppStatus>SUCCEEDED</finalAppStatus>
        <submittedTime>1430425001004</submittedTime>
        <startedTime>1430425001004</startedTime>
        <finishedTime>1430425008861</finishedTime>
        <elapsedTime>7857</elapsedTime>
      </app>
      <app>
        <appId>application_1430424020775_0003</appId>
        <currentAppAttemptId>appattempt_1430424020775_0003_000001</currentAppAttemptId>
        <user>zshen</user>
        <name>DistributedShell</name>
        <queue>default</queue>
        <type>YARN</type>
        <host>d-69-91-129-173.dhcp4.washington.edu/69.91.129.173</host>
        <rpcPort>-1</rpcPort>
        <appState>FINISHED</appState>
        <progress>100.0</progress>
        <diagnosticsInfo></diagnosticsInfo>
        <originalTrackingUrl>N/A</originalTrackingUrl>
        <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0003/</trackingUrl>
        <finalAppStatus>SUCCEEDED</finalAppStatus>
        <submittedTime>1430424956650</submittedTime>
        <startedTime>1430424956650</startedTime>
        <finishedTime>1430424963907</finishedTime>
        <elapsedTime>7257</elapsedTime>
      </app>
      <app>
        <appId>application_1430424020775_0002</appId>
        <currentAppAttemptId>appattempt_1430424020775_0002_000001</currentAppAttemptId>
        <user>zshen</user>
        <name>DistributedShell</name>
        <queue>default</queue>
        <type>YARN</type>
        <host>d-69-91-129-173.dhcp4.washington.edu/69.91.129.173</host>
        <rpcPort>-1</rpcPort>
        <appState>FINISHED</appState>
        <progress>100.0</progress>
        <diagnosticsInfo></diagnosticsInfo>
        <originalTrackingUrl>N/A</originalTrackingUrl>
        <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0002/</trackingUrl>
        <finalAppStatus>SUCCEEDED</finalAppStatus>
        <submittedTime>1430424769395</submittedTime>
        <startedTime>1430424769395</startedTime>
        <finishedTime>1430424776594</finishedTime>
        <elapsedTime>7199</elapsedTime>
      </app>
      <app>
        <appId>application_1430424020775_0001</appId>
        <currentAppAttemptId>appattempt_1430424020775_0001_000001</currentAppAttemptId>
        <user>zshen</user>
        <name>QuasiMonteCarlo</name>
        <queue>default</queue>
        <type>MAPREDUCE</type>
        <host>localhost</host>
        <rpcPort>56264</rpcPort>
        <appState>FINISHED</appState>
        <progress>100.0</progress>
        <diagnosticsInfo></diagnosticsInfo>
        <originalTrackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001</originalTrackingUrl>
        <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/</trackingUrl>
        <finalAppStatus>SUCCEEDED</finalAppStatus>
        <submittedTime>1430424053809</submittedTime>
        <startedTime>1430424053809</startedTime>
        <finishedTime>1430424072153</finishedTime>
        <elapsedTime>18344</elapsedTime>
      </app>
    </apps>

## Application ##

With the Application API, you can get an application resource contains information about a particular application that was running on an YARN cluster.

It is essentially a JSON-serialized form of the YARN ApplicationReport structure.

### URI: ###

Use the following URI to obtain an application object identified by the appid value.

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps/{appid}

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

None

### Elements of the app (Application) Object: ###

<table style="padding:0px; width:1116px; margin-left:-2px; margin-right:-2px; font-size:10px"> 
 <thead> 
  <tr style="background-color:rgb(221,221,221)"> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Item</th> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Data Type</th> 
   <th align="left" style="padding:2px 4px; vertical-align:top; color:white; background-color:rgb(187,187,187); text-align:left; font-size:11px"> Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> appId</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The application ID</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> user</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The user who started the application</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> name</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The application name</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> type</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The application type</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> queue</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The queue to which the application submitted</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> appState</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The application state according to the ResourceManager - valid values are members of the YarnApplicationState enum:&nbsp;FINISHED,&nbsp;FAILED,&nbsp;KILLED</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> finalStatus</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The final status of the application if finished - reported by the application itself - valid values are:&nbsp;UNDEFINED,&nbsp;SUCCEEDED,&nbsp;FAILED,&nbsp;KILLED</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> progress</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> float</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The reported progress of the application as a percent. Long-lived YARN services may not provide a meaninful value here —or use it as a metric of actual vs desired container counts</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> trackingUrl</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The web URL of the application (via the RM Proxy)</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> originalTrackingUrl</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The actual web URL of the application</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> diagnosticsInfo</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> Detailed diagnostics information on a completed application</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> startedTime</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> long</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The time in which application started (in ms since epoch)</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> finishedTime</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> long</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The time in which the application finished (in ms since epoch)</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> elapsedTime</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> long</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The elapsed time since the application started (in ms)</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> allocatedMB</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> int</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The sum of memory in MB allocated to the application’s running containers</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> allocatedVCores</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> int</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The sum of virtual cores allocated to the application’s running containers</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> currentAppAttemptId</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The latest application attempt ID</td> 
  </tr> 
  <tr style="background-color:rgb(221,221,221)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> host</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> string</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The host of the ApplicationMaster</td> 
  </tr> 
  <tr style="background-color:rgb(238,238,238)"> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> rpcPort</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> int</td> 
   <td align="left" style="font-family:Verdana,Helvetica,Arial,sans-serif; font-size:11px; color:rgb(51,51,51); padding:2px 4px; vertical-align:top"> The RPC port of the ApplicationMaster; zero if no IPC service declared.</td> 
  </tr> 
 </tbody> 
</table>

### Response Examples: ###

#### JSON response ####

HTTP Request:

http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "appId": "application_1430424020775_0001",
      "currentAppAttemptId": "appattempt_1430424020775_0001_000001",
      "user": "zshen",
      "name": "QuasiMonteCarlo",
      "queue": "default",
      "type": "MAPREDUCE",
      "host": "localhost",
      "rpcPort": 56264,
      "appState": "FINISHED",
      "progress": 100.0,
      "diagnosticsInfo": "",
      "originalTrackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001",
      "trackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/",
      "finalAppStatus": "SUCCEEDED",
      "submittedTime": 1430424053809,
      "startedTime": 1430424053809,
      "finishedTime": 1430424072153,
      "elapsedTime": 18344
    }

#### XML response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001
    Accept: application/xml

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 873

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <app>
       <appId>application_1430424020775_0001</appId>
       <currentAppAttemptId>appattempt_1430424020775_0001_000001</currentAppAttemptId>
       <user>zshen</user>
       <name>QuasiMonteCarlo</name>
       <queue>default</queue>
       <type>MAPREDUCE</type>
       <host>localhost</host>
       <rpcPort>56264</rpcPort>
       <appState>FINISHED</appState>
       <progress>100.0</progress>
       <diagnosticsInfo></diagnosticsInfo>
       <originalTrackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001</originalTrackingUrl>
       <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/</trackingUrl>
       <finalAppStatus>SUCCEEDED</finalAppStatus>
       <submittedTime>1430424053809</submittedTime>
       <startedTime>1430424053809</startedTime>
       <finishedTime>1430424072153</finishedTime>
       <elapsedTime>18344</elapsedTime>
     </app>

## Application Attempt List ##

With the Application Attempt List API, you can obtain a collection of resources, each of which represents an application attempt. When you run a GET operation on this resource, you obtain a collection of application attempt objects.

### URI: ###

Use the following URI to obtain all the attempt objects of an application identified by the appid value.

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps/{appid}/appattempts

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

None

### Elements of the appattempts (Application Attempt List) Object ###

When you make a request for the list of application attempts, the information will be returned as a collection of application attempt objects. See [Application Attempt][] for the syntax of the application attempt object.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET  http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "appAttempt": [
        {
          "appAttemptId": "appattempt_1430424020775_0001_000001",
          "host": "localhost",
          "rpcPort": 56264,
          "trackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/",
          "originalTrackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001",
          "diagnosticsInfo": "",
          "appAttemptState": "FINISHED",
          "amContainerId": "container_1430424020775_0001_01_000001"
        }
      ]
    }

#### XML response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts
    Accept: application/xml

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/xml

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <appAttempts>
      <appAttempt>
        <appAttemptId>appattempt_1430424020775_0001_000001</appAttemptId>
        <host>localhost</host>
        <rpcPort>56264</rpcPort>
        <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/</trackingUrl>
        <originalTrackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001</originalTrackingUrl>
        <diagnosticsInfo></diagnosticsInfo>
        <appAttemptState>FINISHED</appAttemptState>
        <amContainerId>container_1430424020775_0001_01_000001</amContainerId>
      </appAttempt>
    </appAttempts>

## Application Attempt ##

With the Application Attempt API, you can get an application attempt resource contains information about a particular application attempt of an application that was running on an YARN cluster.

### URI: ###

Use the following URI to obtain an application attempt object identified by the appid value and the appattemptid value.

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps/{appid}/appattempts/{appattemptid}

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

None

### Elements of the appattempt (Application Attempt) Object: ###

### Response Examples: ###

#### JSON response ####

HTTP Request:

http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts/appattempt_1430424020775_0001_000001

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "appAttemptId": "appattempt_1430424020775_0001_000001",
      "host": "localhost",
      "rpcPort": 56264,
      "trackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/",
      "originalTrackingUrl": "http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001",
      "diagnosticsInfo": "",
      "appAttemptState": "FINISHED",
      "amContainerId": "container_1430424020775_0001_01_000001"
    }

#### XML response ####

HTTP Request:

GET http://<timeline server http address:port>/ws/v1/applicationhistory/apps/application_1395789200506_0001/appattempts/appattempt_1395789200506_0001_000001
    Accept: application/xml

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 488

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <appAttempt>
      <appAttemptId>appattempt_1430424020775_0001_000001</appAttemptId>
      <host>localhost</host>
      <rpcPort>56264</rpcPort>
      <trackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:8088/proxy/application_1430424020775_0001/</trackingUrl>
      <originalTrackingUrl>http://d-69-91-129-173.dhcp4.washington.edu:19888/jobhistory/job/job_1430424020775_0001</originalTrackingUrl>
      <diagnosticsInfo></diagnosticsInfo>
      <appAttemptState>FINISHED</appAttemptState>
      <amContainerId>container_1430424020775_0001_01_000001</amContainerId>
    </appAttempt>

## Container List ##

With the Container List API, you can obtain a collection of resources, each of which represents a container. When you run a GET operation on this resource, you obtain a collection of container objects.

### URI: ###

Use the following URI to obtain all the container objects of an application attempt identified by the appid value and the appattemptid value.

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps/{appid}/appattempts/{appattemptid}/containers

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

None

### Elements of the containers (Container List) Object ###

When you make a request for the list of containers, the information will be returned as a collection of container objects. See also Container for syntax of the container object.

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts/appattempt_1430424020775_0001_000001/containers?

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "container": [
        {
          "containerId": "container_1430424020775_0001_01_000007",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 10,
          "startedTime": 1430424068296,
          "finishedTime": 1430424073006,
          "elapsedTime": 4710,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000007/container_1430424020775_0001_01_000007/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000006",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 20,
          "startedTime": 1430424060317,
          "finishedTime": 1430424068293,
          "elapsedTime": 7976,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000006/container_1430424020775_0001_01_000006/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000005",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 20,
          "startedTime": 1430424060316,
          "finishedTime": 1430424068294,
          "elapsedTime": 7978,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000005/container_1430424020775_0001_01_000005/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000003",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 20,
          "startedTime": 1430424060315,
          "finishedTime": 1430424068289,
          "elapsedTime": 7974,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000003/container_1430424020775_0001_01_000003/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000004",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 20,
          "startedTime": 1430424060315,
          "finishedTime": 1430424068291,
          "elapsedTime": 7976,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000004/container_1430424020775_0001_01_000004/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000002",
          "allocatedMB": 1024,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 20,
          "startedTime": 1430424060313,
          "finishedTime": 1430424067250,
          "elapsedTime": 6937,
          "diagnosticsInfo": "Container killed by the ApplicationMaster.\nContainer killed on request. Exit code is 143\nContainer exited with a non-zero exit code 143\n",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000002/container_1430424020775_0001_01_000002/zshen",
          "containerExitStatus": -105,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        },
        {
          "containerId": "container_1430424020775_0001_01_000001",
          "allocatedMB": 2048,
          "allocatedVCores": 1,
          "assignedNodeId": "localhost:9105",
          "priority": 0,
          "startedTime": 1430424054314,
          "finishedTime": 1430424079022,
          "elapsedTime": 24708,
          "diagnosticsInfo": "",
          "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000001/container_1430424020775_0001_01_000001/zshen",
          "containerExitStatus": 0,
          "containerState": "COMPLETE",
          "nodeHttpAddress": "http://localhost:8042"
        }
      ]
    }

#### XML response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts/appattempt_1430424020775_0001_000001/containers
    Accept: application/xml

Response Header:

HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 1428

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <containers>
      <container>
        <containerId>container_1430424020775_0001_01_000007</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>10</priority>
        <startedTime>1430424068296</startedTime>
        <finishedTime>1430424073006</finishedTime>
        <elapsedTime>4710</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000007/container_1430424020775_0001_01_000007/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000006</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>20</priority>
        <startedTime>1430424060317</startedTime>
        <finishedTime>1430424068293</finishedTime>
        <elapsedTime>7976</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000006/container_1430424020775_0001_01_000006/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000005</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>20</priority>
        <startedTime>1430424060316</startedTime>
        <finishedTime>1430424068294</finishedTime>
        <elapsedTime>7978</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000005/container_1430424020775_0001_01_000005/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000003</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>20</priority>
        <startedTime>1430424060315</startedTime>
        <finishedTime>1430424068289</finishedTime>
        <elapsedTime>7974</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000003/container_1430424020775_0001_01_000003/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000004</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>20</priority>
        <startedTime>1430424060315</startedTime>
        <finishedTime>1430424068291</finishedTime>
        <elapsedTime>7976</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000004/container_1430424020775_0001_01_000004/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000002</containerId>
        <allocatedMB>1024</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>20</priority>
        <startedTime>1430424060313</startedTime>
        <finishedTime>1430424067250</finishedTime>
        <elapsedTime>6937</elapsedTime>
        <diagnosticsInfo>Container killed by the ApplicationMaster.
          Container killed on request. Exit code is 143
          Container exited with a non-zero exit code 143
        </diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000002/container_1430424020775_0001_01_000002/zshen</logUrl>
        <containerExitStatus>-105</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
      <container>
        <containerId>container_1430424020775_0001_01_000001</containerId>
        <allocatedMB>2048</allocatedMB>
        <allocatedVCores>1</allocatedVCores>
        <assignedNodeId>localhost:9105</assignedNodeId>
        <priority>0</priority>
        <startedTime>1430424054314</startedTime>
        <finishedTime>1430424079022</finishedTime>
        <elapsedTime>24708</elapsedTime>
        <diagnosticsInfo></diagnosticsInfo>
        <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000001/container_1430424020775_0001_01_000001/zshen</logUrl>
        <containerExitStatus>0</containerExitStatus>
        <containerState>COMPLETE</containerState>
        <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
      </container>
    </containers>

## Container ##

With the Container API, you can get a container resource contains information about a particular container of an application attempt of an application that was running on an YARN cluster.

### URI: ###

Use the following URI to obtain a container object identified by the appid value, the appattemptid value and the containerid value.

http(s)://<timeline server http(s) address:port>/ws/v1/applicationhistory/apps/{appid}/appattempts/{appattemptid}/containers/{containerid}

### HTTP Operations Supported: ###

GET

### Query Parameters Supported: ###

None

### Elements of the container (Container) Object: ###

### Response Examples: ###

#### JSON response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts/appattempt_1430424020775_0001_000001/containers/container_1430424020775_0001_01_000001

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked

Response Body:

{
      "containerId": "container_1430424020775_0001_01_000001",
      "allocatedMB": 2048,
      "allocatedVCores": 1,
      "assignedNodeId": "localhost:9105",
      "priority": 0,
      "startedTime": 1430424054314,
      "finishedTime": 1430424079022,
      "elapsedTime": 24708,
      "diagnosticsInfo": "",
      "logUrl": "http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000001/container_1430424020775_0001_01_000001/zshen",
      "containerExitStatus": 0,
      "containerState": "COMPLETE",
      "nodeHttpAddress": "http://localhost:8042"
    }

#### XML response ####

HTTP Request:

GET http://localhost:8188/ws/v1/applicationhistory/apps/application_1430424020775_0001/appattempts/appattempt_1430424020775_0001_000001/containers/container_1430424020775_0001_01_000001
    Accept: application/xml

Response Header:

HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 669

Response Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <container>
      <containerId>container_1430424020775_0001_01_000001</containerId>
      <allocatedMB>2048</allocatedMB>
      <allocatedVCores>1</allocatedVCores>
      <assignedNodeId>localhost:9105</assignedNodeId>
      <priority>0</priority>
      <startedTime>1430424054314</startedTime>
      <finishedTime>1430424079022</finishedTime>
      <elapsedTime>24708</elapsedTime>
      <diagnosticsInfo></diagnosticsInfo>
      <logUrl>http://0.0.0.0:8188/applicationhistory/logs/localhost:9105/container_1430424020775_0001_01_000001/container_1430424020775_0001_01_000001/zshen</logUrl>
      <containerExitStatus>0</containerExitStatus>
      <containerState>COMPLETE</containerState>
      <nodeHttpAddress>http://localhost:8042</nodeHttpAddress>
    </container>

### Response Codes ###

1.  Queries where a domain, entity type, entity ID or similar cannot be resolved result in HTTP 404, “Not Found” responses.
2.  Requests in which the path, parameters or values are invalid result in Bad Request, 400, responses.
3.  In a secure cluster, a 401, “Forbidden”, response is generated when attempting to perform operations to which the caller does not have the sufficient rights. There is an exception to this when querying some entities, such as Domains; here the API deliberately downgrades permission-denied outcomes as empty and not-founds responses. This hides details of other domains from an unauthorized caller.
4.  If the content of timeline entity PUT operations is invalid, this failure *will not* result in an HTTP error code being retured. A status code of 200 will be returned —however, there will be an error code in the list of failed entities for each entity which could not be added.

[Overview]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Overview
[Introduction]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Introduction
[Current Status]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Current_Status
[Timeline Structure]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Timeline_Structure
[Deployment]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Deployment
[Configurations]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Configurations
[Running the Timeline Server]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Running_Timeline_Server
[Accessing generic-data via command-line]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Accessing_generic-data_via_command-line
[Publishing of application specific data]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Publishing_of_application_specific_data
[Timeline Server REST API]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Timeline_Server_REST_API_v1
[Generic Data REST APIs]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#GENERIC_DATA_REST_APIS
[Timeline Structure 1]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/images/timeline_structure.jpg
[Application Attempt]: https://hadoop.apache.org/docs/stable/hadoop-yarn/hadoop-yarn-site/TimelineServer.html#REST_API_APPLICATION_ATTEMPT