list_collectors
List all monitoring collectors to check health, find available collectors, and monitor capacity before assigning resources.
Instructions
List all LogicMonitor (LM) monitoring collectors (monitoring agents).
Returns: Array of collectors with: id, description (collector name), hostname, platform (Windows/Linux), status (alive/dead), build version, number of monitored resources/devices, last heartbeat time.
When to use:
Check collector health status before adding resources/devices
Find available collectors for new resource/device assignments
Monitor collector capacity and load
Identify offline/dead collectors
What are collectors: Lightweight agents installed on-premise or in cloud that collect metrics from resources/devices. Each resource/device must be assigned to one collector.
Common filter patterns:
Alive collectors: filter:"status:alive"
By platform: filter:"platform:Linux" or filter:"platform:Windows"
By name: filter:"description~*prod*"
Low capacity: filter:"numberOfHosts<100"
Before creating resources/devices: Use this tool to find collectorId for the "preferredCollectorId" parameter in "create_resource".
Important: A negative "total" value in the response indicates incomplete results. Use pagination (size/offset parameters) or set autoPaginate: true to retrieve all items.
Related tools: "get_collector" (details), "list_collector_groups" (browse groups), "list_collector_versions" (check updates).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Number of results per page (default: 50, max: 1000). | |
| offset | No | Starting offset for pagination (default: 0). Use this to skip a specific number of results. | |
| autoPaginate | No | Automatically fetch all pages (default: false). When true, fetches all results across multiple pages. When false, returns only the requested page. Use false for large result sets to avoid long response times. | |
| filter | No | Filter expression using LogicMonitor query syntax. Examples: name:*prod*, displayName~*server*, id>100, hostStatus:normal. Available operators: : (equals), ~ (includes), !: (not equals), !~ (not includes), >: (greater than or equals), <: (less than or equals), > (greater than), < (less than). Multiple conditions: Use comma (,) for AND, use || for OR. Do NOT use &&. | |
| fields | No | Comma-separated list of fields to include in response. Examples: "id,displayName,hostStatus" or use "*" for all fields. Omit this parameter to receive a curated set of commonly used fields. |