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

Lists databases monitored by a collector

Returns a list of databases currently being monitored by the specified collector.

For security reasons, passwords are never included in the API response.

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

URL parameters

id
required string

The unique identifier of the collector.

Headers

Authorization
required string

Bearer $TOKEN

200

A list of databases for the collector.

Response body

{
  "data": [
    {
      "id": "201",
      "type": "collector_database",
      "attributes": {
        "service_type": "postgresql",
        "host": "db1.example.com",
        "port": 5432,
        "username": "betterstack_user",
        "ssl_mode": "require",
        "tls": false,
        "created_at": "2023-10-26T11:00:00.000Z",
        "updated_at": "2023-10-26T11:00:00.000Z"
      }
    },
    {
      "id": "202",
      "type": "collector_database",
      "attributes": {
        "service_type": "redis",
        "host": "cache.example.com",
        "port": 6379,
        "username": null,
        "ssl_mode": null,
        "tls": true,
        "created_at": "2023-10-26T11:05:00.000Z",
        "updated_at": "2023-10-26T11:05: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/databases"


Previous article

List hosts where a collector is running

Next article

OpenTelemetry-native Lightstep alternative