list_resources
Retrieve inventory of all monitored resources/devices. Filter by name, status, or custom properties using simple search or advanced LM filter syntax.
Instructions
List all monitored resources/devices in LogicMonitor (LM) monitoring.
Returns: Array of resource/device with: id, displayName, name (IP/hostname), hostStatus (dead/alive/unknown), preferredCollectorId, deviceType, custom properties, group memberships.
When to use:
Get inventory of all monitored resources/devices
Find specific resource/device by name/IP/property
Check resource/device health status
Get resource/device IDs for other operations
Two search modes:
Simple search: Use query parameter with free text (e.g., query:"production", query:"web-server") - automatically searches displayName, description, and name fields
Advanced filtering: Use filter parameter with LM filter syntax (e.g., filter:"hostStatus:alive,displayName~*web*") for precise control
Common filter patterns:
By name: filter:"displayName~*prod*" (wildcard search)
By status: filter:"hostStatus:alive" or filter:"hostStatus:dead"
By type: filter:"systemProperties.name:system.devicetype,value:server"
By custom property: filter:"customProperties.name:company.team,customProperties.value:teamA"
By collector: filter:"preferredCollectorId:123"
Multiple conditions: filter:"hostStatus:alive,displayName~*web*" (comma = AND)
Query vs Filter:
query: Simplified search across displayName, description, name (OR logic). Use for quick lookups: query:"prod-web-01"
filter: Precise LM filter syntax with any field. Use for complex conditions: filter:"hostStatus:alive,displayName~*prod*"
If both provided, query is converted to filter and combined with provided filter using AND logic
Important: A negative "total" value in the response indicates incomplete results. Use pagination (size/offset parameters) or set autoPaginate: true to retrieve all items.
Performance tips: Use autoPaginate:false for large environments (>1000 resources/devices) and paginate manually to avoid timeouts.
Related tools: "get_resource" (details), "generate_resource_link" (get UI link).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Simple search query. Free text (e.g., "production", "web-server", "192.168.1.100") automatically searches across displayName, description, and name fields. Can also use filter syntax (e.g., "hostStatus:alive") which gets formatted automatically. | |
| 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. |