Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Connections API
    7. Collectors API
      1. List all collectors GET
      2. Get a single collector GET
      3. Create a collector POST
      4. Update a collector PATCH
      5. Remove a collector DELETE
      6. List hosts where a collector is running GET
      7. Lists databases monitored by a collector GET
    8. Query API ↗
  7. Alternative to
    1. Lightstep

List hosts where a collector is running

Returns a list of hosts where the specified collector is running.

GET https://telemetry.betterstack.com/api/v1/collectors/{id}/hosts

URL parameters

id
required string

The unique identifier of the collector.

Headers

Authorization
required string

Bearer $TOKEN

200

A list of hosts for the collector.

Response body

{
  "data": [
    {
      "id": "101",
      "type": "collector_host",
      "attributes": {
        "hostname": "k8s-node-1.example.com",
        "status": "online",
        "version": "0.1.0",
        "ip_address": "10.0.1.10",
        "pinged_at": "2023-10-27T10:05:00.000Z",
        "created_at": "2023-10-26T10:01:00.000Z"
      }
    },
    {
      "id": "102",
      "type": "collector_host",
      "attributes": {
        "hostname": "k8s-node-2.example.com",
        "status": "offline",
        "version": "0.1.0",
        "ip_address": "10.0.1.11",
        "pinged_at": "2023-10-27T09:00:00.000Z",
        "created_at": "2023-10-26T10:02:00.000Z"
      }
    }
  ]
}
401

Invalid or missing authentication token.

404

A collector with the specified ID was not found.

Example Request

cURL
curl -L -H "Authorization: Bearer $TOKEN" \
     "https://telemetry.betterstack.com/api/v1/collectors/1/hosts"


Previous article

Remove a collector

Next article

Lists databases monitored by a collector