list_opsnotes
List all operational notes (OpsNotes) to correlate metric changes with deployments, incidents, and maintenance. Timestamped annotations document operational events and appear on graphs.
Instructions
List all operational notes (OpsNotes) in LogicMonitor (LM) monitoring.
Returns: Array of OpsNotes with: id, note text, timestamp (epoch), who created it, tags, scope (applies to which resources/devices/groups), related SDTs.
What are OpsNotes: Timestamped operational annotations displayed on graphs and dashboards. Document changes, deployments, maintenance, incidents - anything that might affect metrics. Appear as vertical lines on metric graphs at the time they occurred.
When to use:
Correlate metric changes with operational events
Document deployments/changes
Create timeline of incidents and responses
Track maintenance activities
Generate operational reports
Use cases and examples:
Deployments:
"Deployed v2.5.0 to production" (explains CPU spike at deploy time)
"Database schema migration" (explains slow queries during migration)
Incidents:
"Customer reported slow load times - investigating"
"Found memory leak, restarting services"
"Incident resolved - bad cache configuration"
Maintenance:
"Scaled from 10 to 15 instances"
"Updated SSL certificates"
"Cleared old logs, freed 500GB disk"
Benefits:
Troubleshooting: "Latency increased at 2pm" → Check OpsNotes: "Deploy happened at 2pm"
Correlation: Understand cause of metric anomalies
Documentation: Automatic operational timeline
Communication: Share what happened with team
Common filter patterns:
By time: filter:"happenedOn>1730851200" (recent notes)
By tags: filter:"tags~deployment"
By device: filter:"monitorObjectName~prod-web"
Displayed on: Graphs, dashboards, resource/device pages - visible wherever metrics are shown.
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_opsnote" (details), "create_opsnote" (add new), "create_device_sdt" (maintenance windows).
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. |