LogicMonitor acquires Catchpoint, adding Internet and digital experience insight to LM Envision.

Read more

LogicMonitor enables you to run user created and LogicMonitor supported out-of-the-box DiagnosticSource modules to fetch diagnostic data to help troubleshoot issues directly from a Resource. You can run multiple DiagnosticSources at the same time across one or more resources, but the same module cannot be run in parallel on a single resource.

Note: Manual execution of DiagnosticSource is currently not supported for Kubernetes clusters.

LogicMonitor supports the following execution status for a DiagnosticSource module:

Execution StatusIndicates
Not startedThe DiagnosticSource module is not yet run. 
In ProgressThe DiagnosticSource module is currently running. 
SuccessThe DiagnosticSource module is run successfully and has collected relevant data. 
Invalid RequestLogicMonitor server received an invalid JSON request. 
RejectLogicMonitor Collector could not handle the incoming request from the server.
ExceptionThe DiagnosticSource module failed to run due to an error in Collector.
TimeoutTimeout occurs when a script fails to execute due to reasons such as the resource is dead, Collector is down, and so on.

After running the DiagnosticSource, you can view the results generated by the script. This helps identify root cause of the issue you created the DiagnosticSource for. You can view the history of DiagnosticSource module run on a resource. The history provides details of the issues and the diagnosis performed to identify the root cause. You can view the execution history of a resource for a specific time range. 

Requirements for Executing DiagnosticSource

To run a DiagnosticSource module, you need the following:

  • The Security settings configured by enabling the Allow Execution of Diagnostic Sources switch to execute DiagnosticSources
    For more information, see Security Settings.
  • A LogicMonitor user with Diagnostic Source permissions for the resource group in the Resources permission set
    For more information, see Resources Role Permissions.
  • EA Collector 38.400 or later installed
    For more information, see Adding Collector.
  • DiagnosticSource modules in My Module Toolbox and applied to the resources
    For more information, see Configuring DiagnosticSource.
  • Resources including cloud resources monitored by local Collectors
    For more information, see Enabling Cloud Monitoring using Local Collector.

Executing a DiagnosticSource

  1. In LogicMonitor, navigate to Resource Tree.
  2. Locate the resource to which a DiagnosticSource module is applied.
  3. Select the Diagnostics tab.
  4. In the Actions column, select Run DiagnosticSource icon Run for the DiagnosticSource that you want to execute.

Warning: When the system begins to execute the DiagnosticSource, you cannot pause or cancel the execution.

The system runs the DiagnosticSource module and updates the execution status as In Progress.

DiagnosticSource tab on Resources page

When the process is complete, you can view the latest output in the Overview tab.

Note: If the script output is large, it is truncated to a maximum size of 32 KB.

Viewing DiagnosticSource Execution Results

  1. In LogicMonitor, navigate to Resource Tree.
  2. Locate the resource to which a DiagnosticSource module is applied.
  3. Select the Diagnostics tab.
  4. Select a DiagnosticSource.
    By default, the Overview tab displays the following details:
    • Name of the DiagnosticSource
    • Recent execution status
    • Date and time when the DiagnosticSource execution started and ended
    • Username of the user who executed the DiagnosticSource 
    • Output details
    • Option to view output in fullscreen mode, download, and copy the output
      DiagnosticSource execution result in Overview tab

Viewing DiagnosticSource Execution History

  1. In LogicMonitor, navigate to Resource Tree.
  2. Locate the resource to which a DiagnosticSource module is applied.
  3. Select the Diagnostics tab.
  4. Select a DiagnosticSource.
    By default, the Overview tab displays.
  5. Select the History tab.
    DiagnosticSource Execution History of a Resource
  6. (Optional) Select a time range.
  7.  Select a record to view the execution history.
    DiagnosticSource Execution Details in History tab

14-day access to the full LogicMonitor platform