Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    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. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
      1. Sources API
      2. 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. List collector metrics targets GET
        9. Get a single collector metrics target GET
        10. Create a collector metric target POST
        11. Update a collector metrics target PATCH
        12. Remove a collector metric target DELETE
      3. Metrics API
      4. Source groups API
    3. Dashboards
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

Get a single collector metrics target

Returns a single collector target by ID.

GET https://telemetry.betterstack.com/api/v1/collectors/{collector_id}/targets/{target_id}

Headers

Authorization
required string

Bearer $TOKEN

200

The target was returned successfully.

Response body

{
  "data": {
    "id": "1",
    "type": "collector_target",
    "attributes": {
      "kind": "postgres",
      "host": "db.example.com",
      "port": 5432,
      "service": null,
      "listen_ip": null,
      "endpoint": null,
      "scheme": null,
      "username": "monitor",
      "ssl_mode": "require",
      "tls": null,
      "status": "up",
      "enabled": true,
      "container": null,
      "detected_host": null,
      "autogenerated": false,
      "paused_until": null,
      "consecutive_failure_count": 0,
      "last_ping_at": "2025-06-15T14:32:00.000Z",
      "created_at": "2025-06-01T12:00:00.000Z",
      "updated_at": "2025-06-15T14:32:00.000Z"
    }
  }
}
404

The target was not found, or belongs to a different collector or team.

Response body

{
  "errors": "Not found"
}
cURL
curl "https://telemetry.betterstack.com/api/v1/collectors/1/targets/1" \
     -H "Authorization: Bearer $TOKEN"


Previous article

List collector metrics targets

Next article

Create a collector metric target