---++  GET api/instance/triage/:entity-type/:entity-name
   * <a href="#Description">Description</a>
   * <a href="#Parameters">Parameters</a>
   * <a href="#Results">Results</a>
   * <a href="#Examples">Examples</a>

---++ Description
Given a feed/process instance this command traces it's ancestors to find what all ancestors have failed. It's useful if
lot of instances are failing in a pipeline as it then finds out the root cause of the pipeline being stuck.


---++ Parameters
   * :entity-type type of entity(feed/process).
   * :entity-name name of the feed/process.
   * :start instance time of the entity instance.
   * :colo <optional param> name of the colo on which you want to triage
   * doAs <optional query param> allows the current user to impersonate the user passed in doAs when interacting with the Falcon system.

---++ Results
It returns a json graph

---++ Examples
---+++ Rest Call
<verbatim>
GET http://localhost:15000/api/instance/triage/feed/my-feed?start=2015-03-02T00:00Z&colo=local&doAs=joe
</verbatim>
---+++ Result
<verbatim>
{
    "vertices": ["(FEED) my-feed (2015-03-02T00:00Z) [Unavailable]", "(PROCESS) producer-process (2015-03-01T10:00Z) [TIMEDOUT]", "(FEED) input-feed-for-producer (2015-03-01T00:00Z) [Available]"],
    "edges":
    [
        {
         "from"  : "(PROCESS) producer-process (2015-03-01T10:00Z) [TIMEDOUT]",
         "to"    : "(FEED) my-feed (2015-03-02T00:00Z) [Unavailable]",
         "label" : "produces"
        },
        {
         "from"  : "(FEED) input-feed-for-producer (2015-03-01T00:00Z) [Available]",
         "to"    : "(PROCESS) producer-process (2015-03-01T10:00Z) [TIMEDOUT]",
         "label" : "consumed by"
        }
    ]
}
</verbatim>