list_collector_groups
Retrieve a list of collector groups (organizational folders) in LogicMonitor to browse collector organization and find group IDs for further operations.
Instructions
List all collector groups (folders) in LogicMonitor (LM) monitoring.
Returns: Array of collector groups with: id, name, parentId, full path, description, number of collectors, number of subgroups.
What are collector groups: Organizational folders for collectors (monitoring agents), similar to resource/device groups. Used to categorize collectors by location, function, or customer.
When to use:
Browse collector organization
Find group IDs for collector operations
Understand collector deployment structure
Navigate to specific collector folders
Common organization patterns:
By location: "US-West Collectors", "EU Collectors", "APAC Collectors"
By environment: "Production Collectors", "Dev/Test Collectors"
By customer: "Customer A Collectors", "Customer B Collectors" (MSP)
By datacenter: "DC1 Collectors", "DC2 Collectors", "AWS Collectors"
By function: "Network Collectors", "Server Collectors", "Cloud Collectors"
Use cases:
Organize collectors by geographic region
Group collectors by customer or tenant
Separate production vs non-production collectors
Structure multi-datacenter collector deployments
Workflow: Use this tool to browse hierarchy, then "list_collectors" filtered by groupId to see collectors in specific folder.
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_group" (details), "list_collectors" (collectors in group), "create_collector_group" (create folder).
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. |