list_resource_instances
Retrieve all monitored instances (e.g., disks, network interfaces) for a specific device and datasource, providing IDs for metric retrieval.
Instructions
List instances of a datasource on a specific resource/device in LogicMonitor (LM) monitoring.
Returns: Array of instances with: id, name, displayName, description, status, alert status, last collection time.
What are instances: Individual components monitored by a datasource. Examples: individual disks (C:, D:, E:), network interfaces (eth0, eth1), database tables, processes.
When to use:
List all disks on a server before getting disk metrics
Find specific network interface for bandwidth data
Discover what instances are being monitored
Get instance IDs for metric retrieval
Example workflow: Device "web-server-01" has datasource "WinVolumeUsage-" → instances: C:, D:, E: (each disk is an instance) Device "router-01" has datasource "SNMP_Network_Interfaces" → instances: GigabitEthernet0/1, GigabitEthernet0/2 (each interface is an instance)
Complete workflow to get metrics:
Use "list_resource_datasources" to get deviceDataSourceId
Use this tool to list instances and get instanceId
Use "get_resource_instance_data" with instanceId to get actual metrics
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: "list_resource_datasources" (first step), "get_resource_instance_data" (get metrics).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deviceId | Yes | The resource/device ID | |
| deviceDataSourceId | Yes | The resource/device datasource ID | |
| 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. |