时间轴服务V.2

可扩展性

V.1仅限于写入器/读取器和存储的单个实例，并且无法很好地扩展到小型群集之外。V.2使用更具扩展性的分布式写入器体系结构和可扩展的后端存储。

YARN时间轴服务v.2将数据的收集（写入）与数据的提供（读取）分开。它使用分布式收集器，每个YARN应用程序实质上是一个收集器。读取器是专用于通过REST API服务查询的单独实例。

YARN Timeline Service v.2选择Apache HBase作为主要的后备存储，因为Apache HBase可以很好地扩展到较大的大小，同时保持良好的读写响应时间。

可用性改进

在许多情况下，用户对YARN应用程序的“流”级别或逻辑组级别的信息感兴趣。启动一组或一系列YARN应用程序以完成逻辑应用程序更为常见。时间轴服务v.2明确支持流的概念。另外，它支持在流级别汇总指标。

另外，诸如配置和指标之类的信息也被视为一流公民。

下图说明了不同YARN实体建模流程之间的关系。

基本配置

进阶设定

安全配置

可以通过将yarn.timeline-service.http-authentication.type设置为kerberos来启用安全性，之后可以使用以下配置选项：

启用CORS支持

要为时间轴服务v.2启用跨域支持（CORS），请设置以下配置参数：

在yarn-site.xml中，将yarn.timeline-service.http-cross-origin.enabled设置为true。

在core-site.xml中，将org.apache.hadoop.security.HttpCrossOriginFilterInitializer添加到hadoop.http.filter.initializers中。

有关用于跨域支持的更多配置，请参考HttpAuthentication。请注意，yarn.timeline-service.http-cross-origin.enabled如果设置为true，则会覆盖hadoop.http.cross-origin.enabled。

准备Apache HBase集群进行存储

为Timeline Service v.2准备存储需要完成几个步骤：

步骤1）设定HBase丛集

步骤2）启用协处理器

步骤3）为时间轴服务v.2创建架构

每个步骤将在下面更详细地说明。

<配置>
  <属性>
    <name> hbase.rootdir </ name>
    <value> hdfs：//namenode.example.org：8020 / hbase </ value>
  </ property>
  <属性>
    <name> hbase.cluster.distributed </ name>
    <value> false </ value>
  </ property>
</ configuration>

hadoop fs -mkdir / hbase /协处理器
hadoop fs -put hadoop-yarn-server-timelineservice-hbase-coprocessor-3.2.0-SNAPSHOT.jar
       /hbase/coprocessor/hadoop-yarn-server-timelineservice.jar

<属性>
  <name> yarn.timeline-service.hbase.coprocessor.jar.hdfs.location </ name>
  <value> / custom / hdfs / path / jarName </ value>
</ property>

bin / hadoop org.apache.hadoop.yarn.server.timelineservice.storage.TimelineSchemaCreator-创建

yarn.timeline-service.app-flow.table.name
yarn.timeline-service.entity.table.name
yarn.timeline-service.application.table.name
yarn.timeline-service.subapplication.table.name
yarn.timeline-service.flowactivity.table.name
yarn.timeline-service.flowrun.table.name
yarn.timeline-service.domain.table.name

启用时间轴服务v.2

以下是启动时间轴服务v.2的基本配置：

<属性>
  <name> yarn.timeline-service.version </ name>
  <value> 2.0f </ value>
</ property>

<属性>
  <name> yarn.timeline-service.enabled </ name>
  <value> true </ value>
</ property>

<属性>
  <name> yarn.nodemanager.aux-services </ name>
  <value> mapreduce_shuffle，timeline_collector </ value>
</ property>

<属性>
  <name> yarn.nodemanager.aux-services.timeline_collector.class </ name>
  <value> org.apache.hadoop.yarn.server.timelineservice.collector.PerNodeTimelineCollectorsAuxService </ value>
</ property>

<属性>
  <description>控制纱线系统指标是否为
  RM和NM是否在时间轴服务上发布。</ description>
  <name> yarn.system-metrics-publisher.enabled </ name>
  <value> true </ value>
</ property>

另外，如果要使用多个群集将数据存储在同一Apache HBase存储中，则可能需要将YARN群集名称设置为合理的唯一值：

<属性>
  <name> yarn.resourcemanager.cluster-id </ name>
  <value> my_research_test_cluster </ value>
</ property>

另外，将hbase-site.xml配置文件添加到客户端Hadoop集群配置中，以便它可以将数据写入到您正在使用的Apache HBase集群中，或将yarn.timeline-service.hbase.configuration.file设置为文件URL指向到hbase-site.xml相同。例如：

<属性>
  <description>指向hbase-site.xml配置文件的可选URL
  用于连接到时间轴服务hbase集群。如果为空
  指定，则将从类路径中加载HBase配置。
  指定后，指定配置文件中的值将被覆盖
  来自类路径中存在的那些。
  </ description>
  <name> yarn.timeline-service.hbase.configuration.file </ name>
  <值>文件：/etc/hbase/hbase-ats-dc1/hbase-site.xml </值>
</ property>

要同时配置时间轴服务1.5和v.2，请添加以下属性

<属性>
  <name> yarn.timeline-service.versions </ name>
  <value> 1.5f，2.0f </ value>
</ property>

如果未配置以上版本，则默认为yarn.timeline-service.version中设置的版本

运行时间轴服务v.2

重新启动资源管理器以及节点管理器以选择新配置。收集器以嵌入式方式在资源管理器和节点管理器中启动。

时间轴服务阅读器是一个单独的YARN守护程序，可以使用以下语法启动它：

$ yarn-daemon.sh开始时间线读取器

启用MapReduce写入时间轴服务v.2

要将MapReduce框架数据写入Timeline Service v.2，请在mapred-site.xml中启用以下配置：

<属性>
  <name> mapreduce.job.emit-timeline-data </ name>
  <value> true </ value>
</ property>

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} /流/

要么

GET / ws / v2 /时间轴/流/

支持的查询参数：

1. limit-如果指定，则定义要返回的流数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
2. daterange-如果指定，则指定为“ [开始日期]-[结束日期]”（即开始和结束日期用“-”分隔）或单个日期。日期以yyyyMMdd格式解释，并假定为UTC。如果指定了单个日期，则返回该日期所有活动的流。如果同时指定了开始日期和结束日期，则将返回开始日期和结束日期之间所有活动的流。如果仅给出开始日期，则返回在开始日期之后的活动流。如果仅给出结束日期，则返回在结束日期和结束日期之前处于活动状态的流。
   例如：
   “ daterange = 20150711”返回活跃于20150711的流。
   “ daterange = 20150711-20150714”返回活跃于这两个日期之间的流。
   “ daterange = 20150711-”返回在20150711以及之后的活动流。
   “ daterange = -20150711”返回在20150711之前及之前活动的流。
   
3. fromid-如果指定，则从给定的fromid检索下一组流。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ id”：“ test-cluster / 1460419200000 / sjlee @ ds-date”，
    “ type”：“ YARN_FLOW_ACTIVITY”，
    “ createdtime”：0，
    “流量”：[
      {
        “指标”：[]，
        “事件”：[]，
        “ id”：“ sjlee @ ds-date / 1460420305659”，
        “ type”：“ YARN_FLOW_RUN”，
        “ createdtime”：0，
        “信息”：{
          “ SYSTEM_INFO_FLOW_VERSION”：“ 1”，
          “ SYSTEM_INFO_FLOW_RUN_ID”：1460420305659，
          “ SYSTEM_INFO_FLOW_NAME”：“ ds-date”，
          “ SYSTEM_INFO_USER”：“ sjlee”
        }，
        “与...相关”：{}，
        “涉及到”： {}
      }，
      {
        “指标”：[]，
        “事件”：[]，
        “ id”：“ sjlee @ ds-date / 1460420587974”，
        “ type”：“ YARN_FLOW_RUN”，
        “ createdtime”：0，
        “信息”：{
          “ SYSTEM_INFO_FLOW_VERSION”：“ 1”，
          “ SYSTEM_INFO_FLOW_RUN_ID”：1460420587974，
          “ SYSTEM_INFO_FLOW_NAME”：“ ds-date”，
          “ SYSTEM_INFO_USER”：“ sjlee”
        }，
        “与...相关”：{}，
        “涉及到”： {}
      }
    ]，
    “信息”：{
      “ SYSTEM_INFO_CLUSTER”：“测试群集”，
      “ UID”：“测试群集！sjlee！ds-date”，
      “ FROM_ID”：“测试群集！1460419200000！sjlee！ds-date”，
      “ SYSTEM_INFO_FLOW_NAME”：“ ds-date”，
      “ SYSTEM_INFO_DATE”：1460419200000，
      “ SYSTEM_INFO_USER”：“ sjlee”
    }，
    “与...相关”：{}，
    “涉及到”： {}
  }
]

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} /用户/ {用户名称} /流/ {流名称} /运行/

要么

GET / ws / v2 /时间轴/用户/ {用户名} /流/ {流名} /运行/

支持的查询参数：

1. limit-如果指定，则定义要返回的流数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
2. createdtimestart-如果指定，则仅在返回此时间戳后才开始运行流程。
3. createdtimeend-如果指定，则仅在该时间戳返回之前开始流运行。
4. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
   （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
   这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
   这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
   如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
5. 字段 -指定要检索的字段。对于查询流运行，只有ALL或METRICS是有效字段。其他字段将导致HTTP 400（错误请求）响应。如果未指定，则将返回ID，类型，createdtime和info字段作为响应。
6. fromid-如果指定，则从给定的fromid检索下一组流程运行实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ id”：“ sjlee @ ds-date / 1460420587974”，
    “ type”：“ YARN_FLOW_RUN”，
    “ createdtime”：1460420587974，
    “信息”：{
      “ UID”：“ test-cluster！sjlee！ds-date！1460420587974”，
      “ FROM_ID”：“测试群集！sjlee！ds-date！1460420587974”，
      “ SYSTEM_INFO_FLOW_RUN_ID”：1460420587974，
      “ SYSTEM_INFO_FLOW_NAME”：“ ds-date”，
      “ SYSTEM_INFO_FLOW_RUN_END_TIME”：1460420595198，
      “ SYSTEM_INFO_USER”：“ sjlee”
    }，
    “与...相关”：{}，
    “涉及到”： {}
  }，
  {
    “指标”：[]，
    “事件”：[]，
    “ id”：“ sjlee @ ds-date / 1460420305659”，
    “ type”：“ YARN_FLOW_RUN”，
    “ createdtime”：1460420305659，
    “信息”：{
      “ UID”：“ test-cluster！sjlee！ds-date！1460420305659”，
      “ FROM_ID”：“测试群集！sjlee！ds-date！1460420305659”，
      “ SYSTEM_INFO_FLOW_RUN_ID”：1460420305659，
      “ SYSTEM_INFO_FLOW_NAME”：“ ds-date”，
      “ SYSTEM_INFO_FLOW_RUN_END_TIME”：1460420311966，
      “ SYSTEM_INFO_USER”：“ sjlee”
    }，
    “与...相关”：{}，
    “涉及到”： {}
  }
]

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中出现任何问题，或者在字段查询参数中指定了无效字段，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} /用户/ {用户名称} /流/ {流名称} /运行/ {运行ID}

要么

GET / ws / v2 /时间轴/用户/ {用户名} /流/ {流名} /运行次数/ {运行ID}

支持的查询参数：

1. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
   （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
   这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
   这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
   请注意，URL不安全字符（例如空格）必须正确编码。

JSON响应示例：

{
  “指标”：[
    {
      “ type”：“ SINGLE_VALUE”，
      “ id”：“ org.apache.hadoop.mapreduce.lib.input.FileInputFormatCounter：BYTES_READ”，
      “ aggregationOp”：“ NOP”，
      “值”：{
        “ 1465246377261”：118
      }
    }，
    {
      “ type”：“ SINGLE_VALUE”，
      “ id”：“ org.apache.hadoop.mapreduce.lib.output.FileOutputFormatCounter：BYTES_WRITTEN”，
      “ aggregationOp”：“ NOP”，
      “值”：{
        “ 1465246377261”：97
      }
    }
  ]，
  “事件”：[]，
  “ id”：“ varun @ QuasiMonteCarlo / 1465246348599”，
  “ type”：“ YARN_FLOW_RUN”，
  “ createdtime”：1465246348599，
  “与...相关”：{}，
  “信息”：{
    “ UID”：“纱线群集！varun！QuasiMonteCarlo！1465246348599”，
    “ FROM_ID”：“纱线群集！varun！QuasiMonteCarlo！1465246348599”，
    “ SYSTEM_INFO_FLOW_RUN_END_TIME”：1465246378051，
    “ SYSTEM_INFO_FLOW_NAME”：“ QuasiMonteCarlo”，
    “ SYSTEM_INFO_USER”：“ varun”，
    “ SYSTEM_INFO_FLOW_RUN_ID”：1465246348599
  }，
  “涉及到”： {}
}

响应码

1. 如果成功，则返回HTTP 200（OK）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 如果找不到给定流程运行ID的流程运行，则返回HTTP 404（未找到）。
4. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} /用户/ {用户名称} /流/ {流名称} /应用

要么

GET / ws / v2 /时间轴/用户/ {用户名} /流/ {流名} /应用

支持的查询参数：

1. limit-如果指定，则定义要返回的应用程序数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
2. createdtimestart-如果指定，则仅返回在此时间戳之后创建的应用程序。
3. createdtimeend-如果指定，则仅返回在此时间戳之前创建的应用程序。
4. relatedto-如果指定，则匹配的应用程序必须与或不与与实体类型相关联的给定实体相关。relatedto表示为以下形式的表达式：
   “（<< entitytype>：<entityid>：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）<op>！（<entitytype>：<entityid> ：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）”。
   如果relatedto表达式具有实体类型-在括号中以“！”开头指定的实体ID关系，则意味着将不返回在relateds字段中具有这些关系的应用。对于不带“！”的表达式或子表达式，将返回所有在其relatedto字段中具有指定关系的应用程序。“ op”是逻辑运算符，可以是AND或OR。实体类型后可以跟任意数量的实体ID。而且我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：relatedto可以是“（（（（type1：id1：id2：id3，type3：id9）AND！（type2：id7：id8））OR（type1：id4））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
5. isrelatedto-如果指定，则匹配的应用程序必须与与实体类型相关联的给定实体相关或不相关。isrelatedto以与relatedto相同的形式表示。
6. infofilters-如果指定，则匹配的应用程序必须与给定的info键完全匹配，并且必须等于或不等于给定值。info键是一个字符串，但value可以是任何对象。信息过滤器表示为以下形式的表达式：
   “（<< key> <compareop> <value>）<op>（<key> <compareop> <value>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”或“ ene”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不需要匹配存在键；而“ ene”表示不等于，但是必须存在键。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：infofilters可以是“（（（（infokey1 eq value1）AND（infokey2 ne value1））OR（（infokey1 ene value3））”。
   注意：如果value是一个对象，则可以以JSON格式的形式给出值，没有任何空格。
   例如：infofilters可以是（infokey1 eq {“ <key>”：“ <value>”，“ <key>”：“ <value>”…}）。
   请注意，URL不安全字符（例如空格）必须正确编码。
7. conffilters-如果指定，则匹配的应用程序必须与给定的配置名称完全匹配，并且必须等于或不等于给定的配置值。配置名称和值都必须是字符串。conffilters以与infofilters相同的形式表示。
8. metricfilters-如果指定，则匹配的应用程序必须与给定指标完全匹配，并满足与指标值的指定关系。指标ID必须是字符串，并且指标值必须是整数值。度量过滤器表示为以下形式的表达式：
   “（（<metricid> <compareop> <metricvalue>）<op>（<metricid> <compareop> <metricvalue>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”，“ ene”，“ gt”，“ ge”，“ lt”和“ le”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不存在匹配条件，“ ene”表示不等于，但必须存在度量，“ gt”表示大于，“ ge”表示大于或等于，“ lt”表示小于，“ le”表示小于或等于。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：metricfilters可以是“（（（（metric1 eq 50）AND（metric2 gt 40））OR（（metric1 lt 20）））”。
   从本质上讲，这是一个等于“（（metric1 == 50 AND metric2> 40）或（metric1 <20）””的表达式。
   请注意，URL等不安全字符（例如空格）必须进行适当的编码。
9. eventfilters-如果指定，则匹配的应用程序必须包含或不包含取决于表达式的给定事件。eventfilters表示为以下形式的表达式：
   “（<< eventid>，<eventid>）<op>！（<eventid>，<eventid>，<eventid>）”。
   这里， ”！” 表示括弧中以“！”开头的事件均以逗号分隔 必须存在才能匹配。如果是“！” 如果未指定，则括号中的指定事件必须存在。op是逻辑运算符，可以为AND或OR。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：事件过滤器可以是“（（（（event1，event2）AND！（event4））OR（event3，event7，event5））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
10. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
    （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
    这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
    这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
    如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
11. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
    （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
    如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
12. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回应用程序ID，类型（相当于YARN_APPLICATION），信息字段中的应用程序createdtime和UID作为响应。
13. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
14. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
15. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
16. fromid-如果指定，则从给定的fromid检索下一组应用程序实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ YARN_APPLICATION”，
    “ id”：“ application_1465246237936_0001”，
    “ createdtime”：1465246348599，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“ yarn-cluster！application_1465246237936_0001”
      “ FROM_ID”：“纱线群集！varun！QuasiMonteCarlo！1465246348599！application_1465246237936_0001”，
    }，
    “涉及到”： { }
  }，
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ YARN_APPLICATION”，
    “ id”：“ application_1464983628730_0005”，
    “ createdtime”：1465033881959，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱线群集！application_1464983628730_0005”
      “ FROM_ID”：“纱线群集！varun！QuasiMonteCarlo！1465246348599！application_1464983628730_0005”，
    }，
    “涉及到”： { }
  }
]

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} /用户/ {用户名称} /流/ {流名称} /运行/ {运行ID} /应用

要么

GET / ws / v2 /时间轴/用户/ {用户名} /流/ {流名} /运行/ {运行ID} /应用/

支持的查询参数：

1. limit-如果指定，则定义要返回的应用程序数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
2. createdtimestart-如果指定，则仅返回在此时间戳之后创建的应用程序。
3. createdtimeend-如果指定，则仅返回在此时间戳之前创建的应用程序。
4. relatedto-如果指定，则匹配的应用程序必须与或不与与实体类型相关联的给定实体相关。relatedto表示为以下形式的表达式：
   “（<< entitytype>：<entityid>：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）<op>！（<entitytype>：<entityid> ：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）”。
   如果relatedto表达式具有实体类型-在括号中以“！”开头指定的实体ID关系，则意味着将不返回在relateds字段中具有这些关系的应用。对于不带“！”的表达式或子表达式，将返回所有在其relatedto字段中具有指定关系的应用程序。“ op”是逻辑运算符，可以是AND或OR。实体类型后可以跟任意数量的实体ID。而且我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：relatedto可以是“（（（（type1：id1：id2：id3，type3：id9）AND！（type2：id7：id8））OR（type1：id4））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
5. isrelatedto-如果指定，则匹配的应用程序必须与与实体类型相关联的给定实体相关或不相关。isrelatedto以与relatedto相同的形式表示。
6. infofilters-如果指定，则匹配的应用程序必须与给定的info键完全匹配，并且必须等于或不等于给定值。info键是一个字符串，但value可以是任何对象。信息过滤器表示为以下形式的表达式：
   “（<< key> <compareop> <value>）<op>（<key> <compareop> <value>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”或“ ene”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不需要匹配存在键；而“ ene”表示不等于，但是必须存在键。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：infofilters可以是“（（（（infokey1 eq value1）AND（infokey2 ne value1））OR（（infokey1 ene value3））”。
   注意：如果value是一个对象，则可以以JSON格式的形式给出值，没有任何空格。
   例如：infofilters可以是（infokey1 eq {“ <key>”：“ <value>”，“ <key>”：“ <value>”…}）。
   请注意，URL不安全字符（例如空格）必须正确编码。
7. conffilters-如果指定，则匹配的应用程序必须与给定的配置名称完全匹配，并且必须等于或不等于给定的配置值。配置名称和值都必须是字符串。conffilters以与infofilters相同的形式表示。
8. metricfilters-如果指定，则匹配的应用程序必须与给定指标完全匹配，并满足与指标值的指定关系。指标ID必须是字符串，并且指标值必须是整数值。度量过滤器表示为以下形式的表达式：
   “（（<metricid> <compareop> <metricvalue>）<op>（<metricid> <compareop> <metricvalue>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”，“ ene”，“ gt”，“ ge”，“ lt”和“ le”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不存在匹配条件，“ ene”表示不等于，但必须存在度量，“ gt”表示大于，“ ge”表示大于或等于，“ lt”表示小于，“ le”表示小于或等于。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：metricfilters可以是“（（（（metric1 eq 50）AND（metric2 gt 40））OR（（metric1 lt 20）））”。
   从本质上讲，这是一个等于“（（metric1 == 50 AND metric2> 40）或（metric1 <20）””的表达式。
   请注意，URL等不安全字符（例如空格）必须进行适当的编码。
9. eventfilters-如果指定，则匹配的应用程序必须包含或不包含取决于表达式的给定事件。eventfilters表示为以下形式的表达式：
   “（<< eventid>，<eventid>）<op>！（<eventid>，<eventid>，<eventid>）”。
   这里， ”！” 表示括弧中以“！”开头的事件均以逗号分隔 必须存在才能匹配。如果是“！” 如果未指定，则括号中的指定事件必须存在。op是逻辑运算符，可以为AND或OR。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：事件过滤器可以是“（（（（event1，event2）AND！（event4））OR（event3，event7，event5））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
10. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
    （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
    这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
    这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
    如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
11. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
    （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix>…）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
    如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
12. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回应用程序ID，类型（相当于YARN_APPLICATION），信息字段中的应用程序createdtime和UID作为响应。
13. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
14. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
15. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
16. fromid-如果指定，则从给定的fromid检索下一组应用程序实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ id”：“ application_1460419579913_0002”，
    “ type”：“ YARN_APPLICATION”，
    “ createdtime”：1460419580171，
    “信息”：{
      “ UID”：“ test-cluster！sjlee！ds-date！1460419580171！application_1460419579913_0002”
      “ FROM_ID”：“测试群集！sjlee！ds-date！1460419580171！application_1460419579913_0002”，
    }，
    “ configs”：{}，
    “与...相关”：{}，
    “涉及到”： {}
  }
]

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} / apps / {app id}

要么

GET / ws / v2 / timeline / apps / {app id}

支持的查询参数：

1. userid-如果指定，则仅返回属于该用户的应用程序。该查询参数必须与flowname和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
2. flowname-仅返回属于该流名称的应用程序。此查询参数必须与userid和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
3. flowrunid-仅返回属于该流运行ID的应用程序。该查询参数必须与userid和flowname查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
4. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
   （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
   这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
   这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
   如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
5. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
   （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix>…）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
   如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
6. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回应用程序ID，类型（相当于YARN_APPLICATION），信息字段中的应用程序createdtime和UID作为响应。
7. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
8. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
9. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。

JSON响应示例：

{
  “指标”：[]，
  “事件”：[]，
  “ id”：“ application_1460419579913_0002”，
  “ type”：“ YARN_APPLICATION”，
  “ createdtime”：1460419580171，
  “信息”：{
    “ UID”：“ test-cluster！sjlee！ds-date！1460419580171！application_1460419579913_0002”
  }，
  “ configs”：{}，
  “与...相关”：{}，
  “涉及到”： {}
}

响应码

1. 如果成功，则返回HTTP 200（OK）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 如果无法检索流上下文信息或找不到给定应用程序ID的应用程序，则返回HTTP 404（未找到）。
4. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} / apps / {app id} / entities / {entity type}

要么

GET / ws / v2 / timeline / apps / {app id} / entities / {entity type}

支持的查询参数：

1. userid-如果指定，则仅返回属于该用户的实体。该查询参数必须与flowname和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
2. flowname-如果指定，则仅返回属于该流名称的实体。此查询参数必须与userid和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
3. flowrunid-如果指定，则仅返回属于该流运行ID的实体。该查询参数必须与userid和flowname查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
4. limit-如果指定，则定义要返回的实体数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
5. createdtimestart-如果指定，则仅返回在此时间戳之后创建的实体。
6. createdtimeend-如果指定，则仅返回在此时间戳之前创建的实体。
7. relatedto-如果指定，则匹配的实体必须与与实体类型相关联的给定实体相关或不相关。relatedto表示为以下形式的表达式：
   “（<< entitytype>：<entityid>：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）<op>！（<entitytype>：<entityid> ：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）”。
   如果relatedto表达式具有实体类型-括弧内在“！”前指定的实体ID关系，这意味着将不返回在relateds字段中具有这些关系的实体。对于不带“！”的表达式或子表达式，将返回在relateds字段中具有指定关系的所有实体。“ op”是逻辑运算符，可以是AND或OR。实体类型后可以跟任意数量的实体ID。而且我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：relatedto可以是“（（（（type1：id1：id2：id3，type3：id9）AND！（type2：id7：id8））OR（type1：id4））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
8. isrelatedto-如果指定，则匹配的实体必须与与实体类型相关联的给定实体相关或不相关。isrelatedto以与relatedto相同的形式表示。
9. infofilters-如果指定，则匹配的实体必须与给定的info键完全匹配，并且必须等于或不等于给定值。info键是一个字符串，但value可以是任何对象。信息过滤器表示为以下形式的表达式：
   “（<< key> <compareop> <value>）<op>（<key> <compareop> <value>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”或“ ene”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不需要匹配存在键；而“ ene”表示不等于，但是必须存在键。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：infofilters可以是“（（（（infokey1 eq value1）AND（infokey2 ne value1））OR（（infokey1 ene value3））”。
   注意：如果value是一个对象，则可以以JSON格式的形式给出值，没有任何空格。
   例如：infofilters可以是（infokey1 eq {“ <key>”：“ <value>”，“ <key>”：“ <value>”…}）。
   请注意，URL不安全字符（例如空格）必须正确编码。
10. conffilters-如果指定，则匹配的实体必须与给定的配置名称完全匹配，并且必须等于或不等于给定的配置值。配置名称和值都必须是字符串。conffilters以与infofilters相同的形式表示。
11. metricfilters-如果指定，则匹配的实体必须与给定度量完全匹配，并满足与度量值的指定关系。指标ID必须是字符串，并且指标值必须是整数值。metricfilters表示为以下形式的表达式：
    “（<< metricid> <compareop> <metricvalue>）<op>（<metricid> <compareop> <metricvalue>）。”
    这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”，“ ene”，“ gt”，“ ge”，“ lt”和“ le”之一。
    “ eq”表示等于，“ ne”表示不等于，并且不存在匹配条件，“ ene”表示不等于，但必须存在度量，“ gt”表示大于，“ ge”表示大于或等于，“ lt”表示小于，“ le”表示小于或等于。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
    例如：metricfilters可以是“（（（（metric1 eq 50）AND（metric2 gt 40））OR（（metric1 lt 20）））”。
    从本质上讲，这是一个等于“（（metric1 == 50 AND metric2> 40）或（metric1 <20）””的表达式。
    请注意，URL等不安全字符（例如空格）必须进行适当的编码。
12. eventfilters-如果指定，则匹配实体必须包含或不包含给定事件，具体取决于表达式。eventfilters表示为以下形式的表达式：
    “（<< eventid>，<eventid>）<op>！（<eventid>，<eventid>，<eventid>）”。
    这里， ”！” 表示括弧中以“！”开头的事件均以逗号分隔 必须存在才能匹配。如果是“！” 如果未指定，则括号中的指定事件必须存在。op是逻辑运算符，可以为AND或OR。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
    例如：事件过滤器可以是“（（（（event1，event2）AND！（event4））OR（event3，event7，event5））”。
    请注意，URL不安全字符（例如空格）必须正确编码。
13. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
    （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
    这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
    这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
    如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
14. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
    （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
    如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
15. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回信息字段中的实体ID，实体类型，createdtime和UID。
16. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
17. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
18. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
19. fromid-如果指定，则从给定的fromid检索下一组通用实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ YARN_APPLICATION_ATTEMPT”，
    “ id”：“ appattempt_1465246237936_0001_000001”，
    “ createdtime”：1465246358873，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱线群集！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！appattempt_1465246237936_0001_000001”
      “ FROM_ID”：“纱线群集！sjlee！ds日期！1460419580171！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！0！appattempt_1465246237936_0001_000001”
    }，
    “涉及到”： { }
  }，
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ YARN_APPLICATION_ATTEMPT”，
    “ id”：“ appattempt_1465246237936_0001_000002”，
    “ createdtime”：1465246359045，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱线群集！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！appattempt_1465246237936_0001_000002”
      “ FROM_ID”：“纱线群集！sjlee！ds日期！1460419580171！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！0！appattempt_1465246237936_0001_000002”
    }，
    “涉及到”： { }
  }
]

响应码

1. 如果成功，则返回HTTP 200（OK）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 如果无法检索流上下文信息，则返回HTTP 404（未找到）。
4. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} / users / {userid} / entities / {entitytype}

要么

GET / ws / v2 / timeline / users / {userid} / entities / {entitytype}

支持的查询参数：

1. limit-如果指定，则定义要返回的实体数。限制的最大可能值为Long的最大值。如果未指定或值小于0，则限制将被视为100。
2. createdtimestart-如果指定，则仅返回在此时间戳之后创建的实体。
3. createdtimeend-如果指定，则仅返回在此时间戳之前创建的实体。
4. relatedto-如果指定，则匹配的实体必须与与实体类型相关联的给定实体相关或不相关。relatedto表示为以下形式的表达式：
   “（<< entitytype>：<entityid>：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）<op>！（<entitytype>：<entityid> ：<entityid> ...，<entitytype>：<entityid>：<entityid> ...）”。
   如果relatedto表达式具有实体类型-括弧内在“！”前指定的实体ID关系，这意味着将不返回在relateds字段中具有这些关系的实体。对于不带“！”的表达式或子表达式，将返回在relateds字段中具有指定关系的所有实体。“ op”是逻辑运算符，可以是AND或OR。实体类型后可以跟任意数量的实体ID。而且我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：relatedto可以是“（（（（type1：id1：id2：id3，type3：id9）AND！（type2：id7：id8））OR（type1：id4））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
5. isrelatedto-如果指定，则匹配的实体必须与与实体类型相关联的给定实体相关或不相关。isrelatedto以与relatedto相同的形式表示。
6. infofilters-如果指定，则匹配的实体必须与给定的info键完全匹配，并且必须等于或不等于给定值。info键是一个字符串，但value可以是任何对象。信息过滤器表示为以下形式的表达式：
   “（<< key> <compareop> <value>）<op>（<key> <compareop> <value>）”。
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”或“ ene”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不需要匹配存在键；而“ ene”表示不等于，但是必须存在键。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：infofilters可以是“（（（（infokey1 eq value1）AND（infokey2 ne value1））OR（（infokey1 ene value3））”。
   注意：如果value是一个对象，则可以以JSON格式的形式给出值，没有任何空格。
   例如：infofilters可以是（infokey1 eq {“ <key>”：“ <value>”，“ <key>”：“ <value>”…}）。
   请注意，URL不安全字符（例如空格）必须正确编码。
7. conffilters-如果指定，则匹配的实体必须与给定的配置名称完全匹配，并且必须等于或不等于给定的配置值。配置名称和值都必须是字符串。conffilters以与infofilters相同的形式表示。
8. metricfilters-如果指定，则匹配的实体必须与给定度量完全匹配，并满足与度量值的指定关系。指标ID必须是字符串，并且指标值必须是整数值。metricfilters表示为以下形式的表达式：
   “（<< metricid> <compareop> <metricvalue>）<op>（<metricid> <compareop> <metricvalue>）。”
   这里op可以是AND或OR。并且compareop可以是“ eq”，“ ne”，“ ene”，“ gt”，“ ge”，“ lt”和“ le”之一。
   “ eq”表示等于，“ ne”表示不等于，并且不存在匹配条件，“ ene”表示不等于，但必须存在度量，“ gt”表示大于，“ ge”表示大于或等于，“ lt”表示小于，“ le”表示小于或等于。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：metricfilters可以是“（（（（metric1 eq 50）AND（metric2 gt 40））OR（（metric1 lt 20）））”。
   从本质上讲，这是一个等于“（（metric1 == 50 AND metric2> 40）或（metric1 <20）””的表达式。
   请注意，URL等不安全字符（例如空格）必须进行适当的编码。
9. eventfilters-如果指定，则匹配实体必须包含或不包含给定事件，具体取决于表达式。eventfilters表示为以下形式的表达式：
   “（<< eventid>，<eventid>）<op>！（<eventid>，<eventid>，<eventid>）”。
   这里， ”！” 表示括弧中以“！”开头的事件均以逗号分隔 必须存在才能匹配。如果是“！” 如果未指定，则括号中的指定事件必须存在。op是逻辑运算符，可以为AND或OR。我们可以结合任意数量的AND和OR来创建复杂的表达式。括号可用于将表达式组合在一起。
   例如：事件过滤器可以是“（（（（event1，event2）AND！（event4））OR（event3，event7，event5））”。
   请注意，URL不安全字符（例如空格）必须正确编码。
10. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
    （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
    这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
    这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
    如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
11. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
    （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
    ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
    这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
    如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
12. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回信息字段中的实体ID，实体类型，createdtime和UID。
13. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
14. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
15. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
16. fromid-如果指定，则从给定的fromid检索下一组通用实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ TEZ_DAG_ID”，
    “ id”：“ dag_1465246237936_0001_000001”，
    “ createdtime”：1465246358873，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱簇！sjlee！TEZ_DAG_ID！0！dag_1465246237936_0001_000001”
      “ FROM_ID”：“ sjlee！纱簇！TEZ_DAG_ID！0！dag_1465246237936_0001_000001”
    }，
    “涉及到”： { }
  }，
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ TEZ_DAG_ID”，
    “ id”：“ dag_1465246237936_0001_000002”，
    “ createdtime”：1465246359045，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱线群集！sjlee！TEZ_DAG_ID！0！dag_1465246237936_0001_000002！userX”
      “ FROM_ID”：“ sjlee！纱线群集！TEZ_DAG_ID！0！dag_1465246237936_0001_000002！userX”
    }，
    “涉及到”： { }
  }
]

响应码

1. 如果成功，则返回HTTP 200（OK）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间轴/集群/ {集群名称} / apps / {app id} / entities / {entity type} / {entity id}

要么

GET / ws / v2 / timeline / apps / {app id} / entities / {entity type} / {entity id}

支持的查询参数：

1. userid-如果指定，则实体必须属于该用户。该查询参数必须与flowname和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
2. flowname-如果指定，则实体必须属于该流名称。此查询参数必须与userid和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
3. flowrunid-如果指定，则实体必须属于该流运行ID。该查询参数必须与userid和flowname查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
4. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
   （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
   这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
   这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
   如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
5. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
   （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix>…）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
   如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
6. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回信息字段中的实体ID，实体类型，createdtime和UID。
7. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
8. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
9. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
10. entityidprefix定义要获取的实体的ID前缀。如果指定，则实体检索将更快。

JSON响应示例：

{
  “指标”：[]，
  “事件”：[]，
  “ type”：“ YARN_APPLICATION_ATTEMPT”，
  “ id”：“ appattempt_1465246237936_0001_000001”，
  “ createdtime”：1465246358873，
  “与...相关”：{}，
  “ configs”：{}，
  “信息”：{
    “ UID”：“纱线群集！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！0！appattempt_1465246237936_0001_000001”
    “ FROM_ID”：“纱线群集！sjlee！ds日期！1460419580171！application_1465246237936_0001！YARN_APPLICATION_ATTEMPT！0！appattempt_1465246237936_0001_000001”
  }，
  “涉及到”： { }
}

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 如果无法检索流上下文信息或找不到给定实体ID的实体，则返回HTTP 404（未找到）。
4. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 /时间线/集群/ {集群名称} /用户/ {用户ID} /实体/ {实体类型} / {实体ID}

要么

GET / ws / v2 / timeline / users / {userid} / entities / {entitytype} / {entityid}

支持的查询参数：

1. metricstoretrieve-如果指定，则定义要检索的指标或不检索并回发的指标。metricstoretrieve可以是以下形式的表达式：
   （<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）。
   这指定了以逗号分隔的度量ID前缀列表。仅会检索与任何前缀匹配的指标。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<metricprefix>，<metricprefix>，<metricprefix>，<metricprefix>…）
   这指定了以逗号分隔的度量ID前缀列表。仅检索不匹配任何前缀的指标。
   如果指定了metricstoretrieve，是否在字段查询参数中指定。请注意，URL不安全字符（例如空格）必须正确编码。
2. confstoretrieve-如果指定，则定义要检索的配置或不检索并回发的配置。confstoretrieve可以是以下形式的表达式：
   （<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀匹配的配置。括号是可选的，用于简单表达。或者，表达式可以采用以下形式：
   ！（<config_name_prefix>，<config_name_prefix>，<config_name_prefix>，<config_name_prefix> ...）
   这指定以逗号分隔的配置名称前缀列表。仅检索与任何前缀不匹配的配置。
   如果指定了confstoretrieve，则无论是否在字段查询参数中指定了CONFIGS，都将检索配置。请注意，URL不安全字符（例如空格）必须正确编码。
3. 字段 -指定要检索的字段。字段的可能值可以是EVENTS，INFO，CONFIGS，METRICS，RELATES_TO，IS_RELATED_TO和ALL。如果指定了ALL，则将检索所有字段。可以将多个字段指定为以逗号分隔的列表。如果未指定字段，则将返回信息字段中的实体ID，实体类型，createdtime和UID。
4. metricslimit-如果指定，则定义要返回的度量标准数量。仅当指定包含METRICS / ALL或metricstoretrieve的字段时才考虑。否则忽略。metricslimit的最大可能值可以是Integer的最大值。如果未指定或值小于1，并且必须检索指标，则metricslimit将被视为1，即将返回指标的最新单个值。
5. metricstimestart-如果指定，则在此时间戳记之后返回实体的度量标准。
6. metricstimeend-如果指定，则返回此时间戳之前的实体的度量。
7. fromid-如果指定，则从给定的fromid检索下一组通用实体。检索到的实体集包括指定的fromid。fromid应该从与先前发送的流实体响应中的FROM_ID信息键关联的值中获取。

JSON响应示例：

[
  {
    “指标”：[]，
    “事件”：[]，
    “ type”：“ TEZ_DAG_ID”，
    “ id”：“ dag_1465246237936_0001_000001”，
    “ createdtime”：1465246358873，
    “与...相关”：{}，
    “ configs”：{}，
    “信息”：{
      “ UID”：“纱线群集！sjlee！TEZ_DAG_ID！0！dag_1465246237936_0001_000001！userX”
      “ FROM_ID”：“ sjlee！纱线群集！TEZ_DAG_ID！0！dag_1465246237936_0001_000001！userX”
    }，
    “涉及到”： { }
  }
]

响应码

1. 如果成功，则返回HTTP 200（OK）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。

HTTP请求：

GET / ws / v2 / timeline / apps / {appid} / entity-types

要么

GET / ws / v2 /时间轴/集群/ {clusterid} / apps / {appid} / entity-types

支持的查询参数：

1. userid-如果指定，则实体必须属于该用户。该查询参数必须与flowname和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则时间轴阅读器将在执行查询时基于集群和appid获取流上下文信息。
2. flowname-如果指定，则实体必须属于该流名称。此查询参数必须与userid和flowrunid查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。
3. flowrunid-如果指定，则实体必须属于该流运行ID。该查询参数必须与userid和flowname查询参数一起指定，否则将被忽略。如果未指定userid，flowname和flowrunid，则在执行查询时，我们将必须基于集群和appid获取流上下文信息。

JSON响应示例：

{
  YARN_APPLICATION_ATTEMPT，
  YARN_CONTAINER，
  MAPREDUCE_JOB，
  MAPREDUCE_TASK，
  MAPREDUCE_TASK_ATTEMPT
}

响应码

1. 如果成功，则返回HTTP 200（确定）响应。
2. 如果解析请求中发生任何问题，则返回HTTP 400（错误请求）。
3. 如果无法检索流上下文信息或找不到给定实体ID的实体，则返回HTTP 404（未找到）。
4. 对于检索数据时发生的不可恢复错误，将返回HTTP 500（内部服务器错误）。