Github user vanzin commented on a diff in the pull request:
https://github.com/apache/spark/pull/5423#discussion_r33393741
--- Diff: docs/monitoring.md ---
@@ -256,6 +256,157 @@ still required, though there is only one application
available. Eg. to see the
running app, you would go to
`http://localhost:4040/api/v1/applications/[app-id]/jobs`. This is to
keep the paths consistent in both modes.
+## Hadoop YARN Timeline service history provider
+
+As well as the Filesystem History Provider, Spark can integrate with the
Hadoop YARN
+"Application Timeline Service". This is a service which runs in a YARN
cluster, recording
+application- and YARN- published events to a database, retrieving them on
request.
+
+Spark integrates with the timeline service by
+1. Publishing events to the timeline service as applications execute.
+2. Listing application histories published to the timeline service.
+3. Retrieving the details of specific application histories.
+
+### Configuring the Timeline Service
+
+For details on configuring and starting the timeline service, consult the
Hadoop documentation.
+
+From the perspective of Spark, the key requirements are
+1. The YARN timeline service must be running.
+1. Its URL is known, and configured in the `yarn-site.xml` configuration
file.
+1. The user has an Kerberos credentials required to interact with the
service.
+
+The timeline service URL must be declared in the property
`yarn.timeline-service.webapp.address`,
+or, if HTTPS is the protocol, `yarn.timeline-service.webapp.https.address`
+
+The choice between HTTP and HTTPS is made on the value of
`yarn.http.policy`, with can be one of
+`http-only` (default), `https_only` or `http_and_https`; HTTP will be used
unless the policy
+is `https_only`.
+
+Examples:
+
+ <!-- Binding for HTTP endpoint -->
+ <property>
+ <name>yarn.timeline-service.webapp.address</name>
+ <value>atshost.example.org:8188</value>
+ </property>
+
+ <property>
+ <name>yarn.timeline-service.enabled</name>
+ <value>true</value>
+ </property>
+
+
+The root web page of the timeline service can be verified with a web
browser,
+as an easy check that the service is live. For the HTTP
--- End diff --
Looks unfinished?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
