Documentation Plugins Sumo Logic Configure

Configure the Sumo Logic data source

To start querying your Sumo Logic data in Grafana, you need to add and configure the Sumo Logic data source. Configuration involves selecting your API region, setting request parameters, and providing your access credentials.

Before you begin

Before configuring the data source, ensure you have:

• Grafana version: Grafana 11.6.7 or later.
• Grafana plan: A Grafana Cloud Pro or Advanced plan or an activated on-prem Grafana Enterprise license.
• Grafana permissions: Organization administrator role.
• Sumo Logic account: An active Sumo Logic account.
• Sumo Logic access credentials: An access ID and access key pair. Refer to the Sumo Logic Access Keys documentation for instructions on generating credentials.

Add the data source

To add the Sumo Logic data source:

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

Configure settings

The API Region section contains the connection and request settings. The following table describes the available settings.

The following table lists the preset API regions.

Authentication

The Sumo Logic data source uses access ID and access key authentication. This is the only supported authentication method.

To configure authentication:

1. In the Sumo Logic console, generate an access ID and access key pair. Refer to the Sumo Logic Access Keys documentation for instructions.
2. In the data source configuration, enter your credentials in the Authentication method section.

Verify the connection

Click Save & test to verify the data source is configured correctly. A successful connection displays the message Sumo Logic successfully connected.

If the test fails, refer to Troubleshooting for common errors and solutions.

Provision the data source

You can define and configure the Sumo Logic data source in YAML files as part of Grafana’s provisioning system. For more information about provisioning, refer to Provision Grafana.

The following example provisions the Sumo Logic data source with access key authentication:

YAML Copy

apiVersion: 1

datasources:
  - name: Sumo Logic
    type: grafana-sumologic-datasource
    jsonData:
      apiUrl: https://api.sumologic.com/api/
      authMethod: accessKey
      accessId: <ACCESS_ID>
      timeout: 30
      interval: 1000
    secureJsonData:
      accessKey: <ACCESS_KEY>

Replace <ACCESS_ID> and <ACCESS_KEY> with your Sumo Logic credentials. For a complete list of available provisioning settings, refer to the settings tables in the Configure settings and Authentication sections.

Provision with Terraform

You can provision the Sumo Logic data source using the Grafana Terraform provider. For more information about Grafana Terraform provisioning, refer to Provision Grafana with Terraform.

The following example provisions the Sumo Logic data source with access key authentication:

hcl Copy

resource "grafana_data_source" "sumologic" {
  type = "grafana-sumologic-datasource"
  name = "Sumo Logic"

  json_data_encoded = jsonencode({
    apiUrl     = "https://api.sumologic.com/api/"
    authMethod = "accessKey"
    accessId   = "<ACCESS_ID>"
    timeout    = 30
    interval   = 1000
  })

  secure_json_data_encoded = jsonencode({
    accessKey = "<ACCESS_KEY>"
  })
}

Replace <ACCESS_ID> and <ACCESS_KEY> with your Sumo Logic credentials.

Next steps

After configuring the data source, you can:

• Build queries using the metrics visual builder or raw query editor.
• Create template variables for dynamic dashboards.
• Set up alert rules to monitor your Sumo Logic metrics.