The Hosts API provides endpoints for managing the hosts tracing your applications.
GET /api-v2/hosts
Return a list of all hosts traced.
This list will be sorted in reverse chronological order of the last trace that the host has seen.
Sample
{
"data": [
{
"first_heartbeat": 1385074694,
"id": 123456,
"last_heartbeat": 1408641942,
"last_trace": 1408641600,
"name": "dev_testing"
},
{
"first_heartbeat": 1395337803,
"id": 654321,
"last_heartbeat": 1408641930,
"last_trace": None,
"name": "web_production"
}
],
"response": "ok"
}
GET /api-v2/hosts/<host_id>/versions
Returns a list of the instrumentation installed on a host, and the current version of that instrumentation. A platform key is set if the instrumentation reports it (can be "linux" or "windows").
Sample
{
"data":[
{
"release_date": 1402876800,
"version": "1.3.0",
"platform": null,
"name": "nginx",
"update_required": false
},
{
"release_date": 1392249600,
"version": 1.1.0,
"platform": "linux",
"name": "tracelyzer",
"update_required": true
}
]
"response": "ok"
}
GET /api-v2/app/<appname>/hosts
Returns a list of hosts assigned to the specified app.
Sample
{
"data": [
{
"first_heartbeat": 1385074694,
"id": 123456,
"last_heartbeat": 1408641942,
"last_trace": 1408641600,
"name": "dev_testing"
},
{
"first_heartbeat": 1395337803,
"id": 654321,
"last_heartbeat": 1408641930,
"last_trace": None,
"name": "web_production"
}
],
"response": "ok"
}
DELETE /api-v2/hosts/<host_id>
Returns True if the host is successfully deleted.
Sample
{
"data": true,
"response":"ok"
}
Raises an error if no host with the specified ID is found, or multiple hosts are found.
Sample
{
"data": "No host found with ID 123456789",
"response": "error"
}