You are viewing a plain text version of this content. The canonical link for it is here.
Posted to yarn-issues@hadoop.apache.org by "Sushil Ks (Jira)" <ji...@apache.org> on 2020/07/20 07:54:01 UTC
[jira] [Updated] (YARN-9016) DocumentStore as a backend for ATSv2
[ https://issues.apache.org/jira/browse/YARN-9016?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Sushil Ks updated YARN-9016:
----------------------------
Description:
h1. Document Store for ATSv2
The Document Store for ATSv2 is a framework for plugging in any Document Store Vendor as a backend for ATSv2 i.e Azure CosmosDB , MongoDB, ElasticSearch etc.
* Supports multiple Document Store Vendors like CosmosDB, ElasticSearch, MongoDB etc by just adding new configurations properties and writing Document Store reader and writer clients.
* Currently has support for CosmosDB.
* All writes are Async and buffered, latest document would be flushed to the store either if the document buffer gets full or periodically at every flush interval in background without adding any additional latency to the running jobs..
* All the REST API's of Timeline Reader Server are supported.
h3. *How to enable?*
Add the flowing properties under *yarn-site.xml*
{code:java}
<!-- config required for ATSv2 to use DocumentStore-->
<property>
<name>yarn.timeline-service.writer.class </name>
<value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreTimelineWriterImpl</value>
</property>
<property>
<name>yarn.timeline-service.reader.class </name> <value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreTimelineReaderImpl</value>
</property>
<property>
<name>yarn.timeline-service.document-store.db-name</name>
<value>YOUR_DATABASE_NAME</value> <!-- default is timeline_service -->
</property>{code}
h3. *Creating DB and Collections for storing documents*
The following config needs to be set inside *yarn-site.xml* for creating the database and collections for storing documents.
{code:java}
<!-- Using schema creator class for DocumentStore-->
<property>
<name>yarn.timeline-service.schema-creator.class </name>
<value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreCollectionCreator</value>
</property>{code}
Running the schema creator tool to create the necessary collections.
{code:java}
bin/hadoop org.apache.hadoop.yarn.server.timelineservice.storage.TimelineSchemaCreator{code}
h3. *Azure CosmosDB*
To use Azure CosmosDB as a DocumentStore for ATSv2, the additional properties under *yarn-site.xml* is required..
{code:java}
<!-- config required for using Azure CosmosDB as a DocumentStore for ATSv2 -->
<property>
<name>yarn.timeline-service.document-store-type</name>
<value>COSMOS_DB</value>
</property>
<property>
<name>yarn.timeline-service.document-store.cosmos-db.endpoint</name>
<value>http://YOUR_AZURE_COSMOS_DB_URL:443/</value>
</property>
<property>
<name>yarn.timeline-service.document-store.cosmos-db.masterkey</name>
<value>YOUR_AZURE_COSMOS_DB_MASTER_KEY_CREDENTIAL</value>
</property>
{code}
*Testing locally*
In order to test the Azure CosmosDB as a DocumentStore locally, install the emulator from [here|https://docs.microsoft.com/en-us/azure/cosmos-db/local-emulator] and start it locally. Set the endpoint and master key under *yarn-site.xml* as mentioned above and run any example job like DistributedShell etc. Later you can check the data explorer UI of Azure CosmosDB locally to query the documents or even launch the *TimelineReader* locally to fetch/query the data from REST API's.
was:
h1. Document Store for ATSv2
The Document Store for ATSv2 is a framework for plugging in any Document Store Vendor as a backend for ATSv2 i.e Azure CosmosDB , MongoDB, ElasticSearch etc.
* Supports multiple Document Store Vendors like CosmosDB, ElasticSearch, MongoDB etc by just adding new configurations properties and writing Document Store reader and writer clients.
* Currently has support for CosmosDB.
* All writes are Async and buffered, latest document would be flushed to the store either if the document buffer gets full or periodically at every flush interval in background without adding any additional latency to the running jobs..
* All the REST API's of Timeline Reader Server are supported.
h3. *How to enable?*
Add the flowing properties under *yarn-site.xml*
{code:java}
<!-- config required for ATSv2 to use DocumentStore-->
<property>
<name>yarn.timeline-service.writer.class </name>
<value>org.apache.hadoop.yarn.server.timelineservice.storage.documentstore.DocumentStoreTimelineWriterImpl</value>
</property>
<property>
<name>yarn.timeline-service.reader.class </name> <value>org.apache.hadoop.yarn.server.timelineservice.storage.documentstore.DocumentStoreTimelineReaderImpl</value>
</property>
<property>
<name>yarn.timeline-service.document-store.db-name</name>
<value>YOUR_DATABASE_NAME</value> <!-- default is timeline_service -->
</property>{code}
h3. *Creating DB and Collections for storing documents*
The following config needs to be set inside *yarn-site.xml* for creating the database and collections for storing documents.
{code:java}
<!-- Using schema creator class for DocumentStore-->
<property>
<name>yarn.timeline-service.schema-creator.class </name>
<value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreCollectionCreator</value>
</property>{code}
Running the schema creator tool to create the necessary collections.
{code:java}
bin/hadoop org.apache.hadoop.yarn.server.timelineservice.storage.TimelineSchemaCreator{code}
h3. *Azure CosmosDB*
To use Azure CosmosDB as a DocumentStore for ATSv2, the additional properties under *yarn-site.xml* is required..
{code:java}
<!-- config required for using Azure CosmosDB as a DocumentStore for ATSv2 -->
<property>
<name>yarn.timeline-service.document-store-type</name>
<value>COSMOS_DB</value>
</property>
<property>
<name>yarn.timeline-service.document-store.cosmos-db.endpoint</name>
<value>http://YOUR_AZURE_COSMOS_DB_URL:443/</value>
</property>
<property>
<name>yarn.timeline-service.document-store.cosmos-db.masterkey</name>
<value>YOUR_AZURE_COSMOS_DB_MASTER_KEY_CREDENTIAL</value>
</property>
{code}
*Testing locally*
In order to test the Azure CosmosDB as a DocumentStore locally, install the emulator from [here|https://docs.microsoft.com/en-us/azure/cosmos-db/local-emulator] and start it locally. Set the endpoint and master key under *yarn-site.xml* as mentioned above and run any example job like DistributedShell etc. Later you can check the data explorer UI of Azure CosmosDB locally to query the documents or even launch the *TimelineReader* locally to fetch/query the data from REST API's.
> DocumentStore as a backend for ATSv2
> ------------------------------------
>
> Key: YARN-9016
> URL: https://issues.apache.org/jira/browse/YARN-9016
> Project: Hadoop YARN
> Issue Type: New Feature
> Components: ATSv2
> Reporter: Sushil Ks
> Assignee: Sushil Ks
> Priority: Major
> Fix For: 3.3.0
>
> Attachments: YARN-9016.001.patch, YARN-9016.002.patch, YARN-9016.003.patch, YARN-9016.004.patch
>
>
> h1. Document Store for ATSv2
> The Document Store for ATSv2 is a framework for plugging in any Document Store Vendor as a backend for ATSv2 i.e Azure CosmosDB , MongoDB, ElasticSearch etc.
> * Supports multiple Document Store Vendors like CosmosDB, ElasticSearch, MongoDB etc by just adding new configurations properties and writing Document Store reader and writer clients.
> * Currently has support for CosmosDB.
> * All writes are Async and buffered, latest document would be flushed to the store either if the document buffer gets full or periodically at every flush interval in background without adding any additional latency to the running jobs..
> * All the REST API's of Timeline Reader Server are supported.
> h3. *How to enable?*
> Add the flowing properties under *yarn-site.xml*
> {code:java}
> <!-- config required for ATSv2 to use DocumentStore-->
> <property>
> <name>yarn.timeline-service.writer.class </name>
> <value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreTimelineWriterImpl</value>
> </property>
> <property>
> <name>yarn.timeline-service.reader.class </name> <value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreTimelineReaderImpl</value>
> </property>
> <property>
> <name>yarn.timeline-service.document-store.db-name</name>
> <value>YOUR_DATABASE_NAME</value> <!-- default is timeline_service -->
> </property>{code}
> h3. *Creating DB and Collections for storing documents*
> The following config needs to be set inside *yarn-site.xml* for creating the database and collections for storing documents.
> {code:java}
> <!-- Using schema creator class for DocumentStore-->
> <property>
> <name>yarn.timeline-service.schema-creator.class </name>
> <value>org.apache.hadoop.yarn.server.timelineservice.documentstore.DocumentStoreCollectionCreator</value>
> </property>{code}
> Running the schema creator tool to create the necessary collections.
> {code:java}
> bin/hadoop org.apache.hadoop.yarn.server.timelineservice.storage.TimelineSchemaCreator{code}
> h3. *Azure CosmosDB*
> To use Azure CosmosDB as a DocumentStore for ATSv2, the additional properties under *yarn-site.xml* is required..
> {code:java}
> <!-- config required for using Azure CosmosDB as a DocumentStore for ATSv2 -->
> <property>
> <name>yarn.timeline-service.document-store-type</name>
> <value>COSMOS_DB</value>
> </property>
> <property>
> <name>yarn.timeline-service.document-store.cosmos-db.endpoint</name>
> <value>http://YOUR_AZURE_COSMOS_DB_URL:443/</value>
> </property>
> <property>
> <name>yarn.timeline-service.document-store.cosmos-db.masterkey</name>
> <value>YOUR_AZURE_COSMOS_DB_MASTER_KEY_CREDENTIAL</value>
> </property>
> {code}
>
> *Testing locally*
> In order to test the Azure CosmosDB as a DocumentStore locally, install the emulator from [here|https://docs.microsoft.com/en-us/azure/cosmos-db/local-emulator] and start it locally. Set the endpoint and master key under *yarn-site.xml* as mentioned above and run any example job like DistributedShell etc. Later you can check the data explorer UI of Azure CosmosDB locally to query the documents or even launch the *TimelineReader* locally to fetch/query the data from REST API's.
>
>
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: yarn-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: yarn-issues-help@hadoop.apache.org