[YARN-3692] Allow REST API to set a user generated message when killing an application

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.8.0, 3.0.0-alpha2
• Target Version/s: 2.9.0
• Hadoop Flags: Reviewed
• Assignee: Rohith Sharma K S
• Reporter: Rajat Jain
• Created: 20/May/15 18:13
• Updated: 08/Nov/21 07:43
• Resolved: 24/Sep/16 17:30

Description

Currently YARN's REST API supports killing an application without setting a diagnostic message. It would be good to provide that support.

Use Case
Usually this helps in workflow management in a multi-tenant environment when the workflow scheduler (or the hadoop admin) wants to kill a job - and let the user know the reason why the job was killed. Killing the job by setting a diagnostic message is a very good solution for that. Ideally, we can set the diagnostic message on all such interface:
yarn kill -applicationId ... -diagnosticMessage "some message added by admin/workflow"
REST API

{ 'state': 'KILLED', 'diagnostics': 'some message added by admin/workflow'}