Documentation Plugins LogicMonitor Devices

LogicMonitor Devices data source plugin

LogicMonitor Devices Grafana Enterprise data source plugin

The LogicMonitor Devices data source allows you to query and visualize LogicMonitor device metrics in Grafana.

Supported features

Before you begin

Before configuring the LogicMonitor Devices data source, ensure you have:

• Grafana permissions: Organization administrator role to add data sources
• LogicMonitor account: Access to a LogicMonitor portal with REST API v3 bearer token
• Grafana version: Any free or paid Grafana Cloud plan, or an activated on-prem Grafana Enterprise license

Install the plugin

To install the data source, refer to the Installation guide.

Configure the data source

To add the LogicMonitor Devices data source:

1. Click Connections in the left-side menu.
2. Click Add new connection.
3. Type LogicMonitor in the search bar.
4. Select LogicMonitor Devices.
5. Click Add new data source.

Basic settings

Authentication

This plugin supports bearer token–based authentication. To create a token:

1. Log in to your LogicMonitor portal.
2. Navigate to Settings > Users and Roles.
3. (Optional) Add a new user with a readonly role if one doesn’t already exist.
4. Go to the Bearer Tokens tab.
5. Create a new token for the associated user.

Verify the connection

Click Save & test to verify the connection. A successful test displays the message “health check succeeded for ‘metrics usage details’ query”. If the connection fails, refer to Troubleshoot LogicMonitor data source issues.

Provision the data source

You can configure this data source using configuration files with the Grafana provisioning system. For more information, refer to Provisioning Grafana data sources.

Example provisioning configuration:

YAML Copy

apiVersion: 1
datasources:
  - name: LogicMonitor
    type: grafana-logicmonitor-datasource
    jsonData:
      variables:
        account_name: <ACCOUNT_NAME>
      authMethod: bearer
    secureJsonData:
      logicmonitor.token: <TOKEN>

Replace <ACCOUNT_NAME> with your LogicMonitor account name and <TOKEN> with your LogicMonitor REST API v3 bearer token.

Provision the data source with Terraform

You can configure this data source using the Grafana Terraform provider.

hcl Copy

resource "grafana_data_source" "logicmonitor" {
  type = "grafana-logicmonitor-datasource"
  name = "LogicMonitor"

  json_data_encoded = jsonencode({
    variables = {
      account_name = "<ACCOUNT_NAME>"
    }
    authMethod = "bearer"
  })

  secure_json_data_encoded = jsonencode({
    "logicmonitor.token" = "<TOKEN>"
  })
}

Replace <ACCOUNT_NAME> with your LogicMonitor account name and <TOKEN> with your LogicMonitor REST API v3 bearer token.

Query the data source

The query editor allows you to run queries by selecting an Action Type and providing the required parameters.

Device Instance Data

Retrieve time series data for individual device instances.

Device Instance Data by Device Group

Retrieve time series data for devices within a specific device group.

Table queries

Use these query types to retrieve and display data in table format:

• Devices: Lists all available devices in your LogicMonitor account.
• Datasources: Lists all data sources within a selected device.
• Instances: Lists all instances within a selected device and data source.

Use Explore

Use Explore to run queries and visualize results without building a dashboard. For more information, refer to Explore.

Query examples

The following examples show common use cases for querying LogicMonitor data.

Monitor CPU utilization

To monitor CPU performance for a specific device:

1. Select Device Instance Data as the action type.
2. Select your target device from the Device drop-down.
3. Select CPU from the Datasource drop-down.
4. Select the CPU instance from the Instance drop-down.
5. (Optional) Select specific data points like cpu_utilization from DataPoints.

Compare devices across a group

To compare metrics across all devices in a group:

1. Select Device Instance Data by Device Group as the action type.
2. Select your device group from the Device Group drop-down.
3. Select a device, data source, and instance.
4. Duplicate the query for each device you want to compare.

Template variables

Use template variables to create dynamic, reusable dashboards.

To add a LogicMonitor query variable:

1. Navigate to Dashboard settings > Variables.
2. Click Add variable.
3. Select Query as the variable type.
4. Select the LogicMonitor Devices data source.
5. Enter your query.

For more information about adding query variables, refer to Add a query variable.

After creating a variable, use it in your LogicMonitor queries with variable syntax. For more information, refer to Templates and variables.

Set up alerting

The LogicMonitor Devices data source supports Grafana alerting on Device Instance Data metrics.

To create an alert rule:

1. Create a panel with a LogicMonitor Device Instance Data query.
2. Click Alert in the panel edit view.
3. Click Create alert rule from this panel.
4. Configure the alert conditions based on your LogicMonitor metrics.
5. Set notification policies and contact points.

For more information about Grafana alerting, refer to Grafana Alerting.

Add annotations

Annotations allow you to mark points on a graph with rich events. You can use LogicMonitor data to create annotations on your dashboards.

To add an annotation query:

1. Navigate to Dashboard settings > Annotations.
2. Click Add annotation query.
3. Select the LogicMonitor Devices data source.
4. Configure a query that returns the events you want to annotate.

For more information about annotations, refer to Annotate visualizations.

Troubleshoot LogicMonitor data source issues

This section provides solutions to common issues when configuring or using the LogicMonitor Devices data source.

Authentication errors

Query errors

Get additional help

If you’ve tried the solutions in this document and still encounter issues:

• Check the Grafana community forums for similar issues.
• Review LogicMonitor plugin issues on GitHub for known bugs.
• Consult the LogicMonitor API documentation for service-specific guidance.
• Contact Grafana Support if you’re a Grafana Enterprise, Cloud Pro, or Cloud Contracted user.

When reporting issues, include:

• Grafana version
• LogicMonitor plugin version
• Error messages (redact sensitive information)
• Steps to reproduce
• Data source configuration (redact credentials)

Plugin updates

Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.

Learn more

• Grafana Alerting
• Annotate visualizations
• Templates and variables
• Transformations
• LogicMonitor REST API documentation