hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From xg...@apache.org
Subject hadoop git commit: YARN-3723. Need to clearly document primaryFilter and otherInfo value type. Contributed by Zhijie Shen
Date Thu, 28 May 2015 17:21:19 GMT
Repository: hadoop
Updated Branches:
  refs/heads/branch-2.7 02ab202a2 -> 3f188272a


YARN-3723. Need to clearly document primaryFilter and otherInfo value
type. Contributed by Zhijie Shen

(cherry picked from commit 3077c299da4c5142503c9f92aad4b82349b2fde2)
(cherry picked from commit 550b55146d012fed7331bcd9b46fa6d130019105)


Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo
Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/3f188272
Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/3f188272
Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/3f188272

Branch: refs/heads/branch-2.7
Commit: 3f188272afcacf4a4b888bbadc755bedea183b09
Parents: 02ab202
Author: Xuan <xgong@apache.org>
Authored: Thu May 28 10:19:36 2015 -0700
Committer: Xuan <xgong@apache.org>
Committed: Thu May 28 10:21:06 2015 -0700

----------------------------------------------------------------------
 hadoop-yarn-project/CHANGES.txt                 |  3 +++
 .../src/site/markdown/TimelineServer.md         | 20 ++++++++++++++++----
 2 files changed, 19 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hadoop/blob/3f188272/hadoop-yarn-project/CHANGES.txt
----------------------------------------------------------------------
diff --git a/hadoop-yarn-project/CHANGES.txt b/hadoop-yarn-project/CHANGES.txt
index f017496..409178e 100644
--- a/hadoop-yarn-project/CHANGES.txt
+++ b/hadoop-yarn-project/CHANGES.txt
@@ -14,6 +14,9 @@ Release 2.7.1 - UNRELEASED
     YARN-3539. Updated timeline server documentation and marked REST APIs evolving.
     (Steve Loughran via zjshen)
 
+    YARN-3723. Need to clearly document primaryFilter and otherInfo value type.
+    (Zhijie Shen via xgong)
+
   OPTIMIZATIONS
 
     YARN-3006. Improve the error message when attempting manual failover with 

http://git-wip-us.apache.org/repos/asf/hadoop/blob/3f188272/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/TimelineServer.md
----------------------------------------------------------------------
diff --git a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/TimelineServer.md
b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/TimelineServer.md
index acdd8ff..fde654b 100644
--- a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/TimelineServer.md
+++ b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/TimelineServer.md
@@ -639,11 +639,20 @@ Use the following URI to obtain all the entity objects of a given
   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.
+`Timeline Entity` for syntax of the timeline entity object.
 
 | Item | Data Type | Description|
 |:---- |:---- |:---- |
@@ -742,7 +751,9 @@ Use the following URI to obtain the entity object identified by the
 
 ### Elements of the `entity` (Timeline Entity) Object:
 
-See also {{Timeline Event List}} for syntax of the timeline event 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.
 
 
 | Item | Data Type | Description|
@@ -832,7 +843,8 @@ will be returned as a collection of event objects.
 |:---- |:---- |:---- |
 | `events` | array of timeline event objects(JSON) | The collection of timeline event objects
|
 
-Below is the elements of a single event object.
+Below is the elements of a single event object.  Note that `value` of
+`eventinfo` and `otherinfo` is an Object instead of a String.
 
 
 | Item | Data Type | Description|
@@ -1451,7 +1463,7 @@ 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
+returned as a collection of container objects. See also `Container` for
 syntax of the container object.
 
 | Item | Data Type   | Description |


Mime
View raw message