> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/use-harness-platform/connectors/monitoring-and-logging-systems/add-a-sumo-logic-connector.md).

# Add a Sumo Logic connector

Add a Sumo Logic connector so Harness can use Sumo Logic as a verification provider.

Sumo Logic is a cloud-based log management and analytics platform that collects, searches, and analyzes machine data from applications and infrastructure. Add a Sumo Logic connector in Harness to let your pipelines query the Sumo Logic logs and metrics. Harness can use that data in Continuous Verification to compare log patterns and detect anomalies after a deployment, helping you confirm a release is healthy, or trigger a rollback.

Go to [Overview](https://developer.harness.io/harness-platform/use-harness-platform/connectors/monitoring-and-logging-systems/monitoring-and-logging-systems-connectors-overview.md) for information about all monitoring and logging connectors, such as scopes and delegate selection.

***

## What you will learn from this topic

* How to [add a Sumo Logic connector](#add-a-sumo-logic-connector) to your Harness project.
* How to configure the [API server URL, access ID, and access key](#credentials) that Harness uses to connect to Sumo Logic.

***

## Before you begin

* **Sumo Logic access ID and access key**: A Sumo Logic access ID and access key. Go to [Access keys](https://help.sumologic.com/docs/manage/security/access-keys/) in the Sumo Logic documentation to create them.
* **API server URL**: The API server URL for the deployment region of your Sumo Logic account.
* **Harness permissions**: Permission to create connectors and secrets in Harness.

***

## Add a Sumo Logic connector

You can add a Sumo Logic connector at the project, org, or account scope. This procedure covers the project scope, and the process is the same for org and account scope.

1. Open your Harness project.
2. In **Project Settings**, select **Connectors**.
3. Click **New Connector**, then select **Sumo Logic** under **Monitoring and Logging Systems**. The Sumo Logic connector settings appear.

### Overview

Configure the identity fields for the connector:

1. In **Name**, enter a name for the connector. Harness generates the **Id** from the name.
2. Optionally, add a **Description** and **Tags**.
3. Click **Continue**.

![Sumo Logic connector overview settings](https://173309742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3F2TpHXhur2QtQnORSM9%2Fuploads%2Fgit-blob-8e0dacc34e871a93d5af7547d1a96ba49697e63e%2Fsumo-logic-connector-overview.png?alt=media)

### Credentials

Configure the following settings:

1. In **Sumo Logic API Server URL**, select the API server URL for the deployment of your Sumo Logic account. The dropdown lists the following URLs:
   * `https://api.sumologic.com/`
   * `https://api.us2.sumologic.com/`
   * `https://api.eu.sumologic.com/`
   * `https://api.de.sumologic.com/`
   * `https://api.ca.sumologic.com/`
   * `https://api.au.sumologic.com/`
   * `https://api.jp.sumologic.com/`
   * `https://api.in.sumologic.com/`
   * `https://api.fed.sumologic.com/`
2. In **Encrypted Access Id**, click **Create or Select a Secret**, then select or create a new [Harness encrypted text secret](https://developer.harness.io/harness-platform/use-harness-platform/secrets/add-use-text-secrets.md) to store your Sumo Logic access ID.
3. In **Encrypted Access Key**, click **Create or Select a Secret**, then select or create a new [Harness encrypted text secret](https://developer.harness.io/harness-platform/use-harness-platform/secrets/add-use-text-secrets.md) to store your Sumo Logic access key.
4. Click **Next**.

![Sumo Logic connector credentials with the API server URL, access ID, and access key fields](https://173309742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3F2TpHXhur2QtQnORSM9%2Fuploads%2Fgit-blob-04be31919b9a5b5dad9dcf2f197120d37a500b7a%2Fsumo-logic-connector-credentials.png?alt=media)

{% hint style="info" %}
**Match the URL to your deployment**

Select the API server URL that matches the deployment where your Sumo Logic account is hosted. If the URL does not match, the connection test fails. Go to [Sumo Logic API authentication, endpoints, and rate limits](https://help.sumologic.com/docs/api/getting-started/) in the Sumo Logic documentation to find your deployment.
{% endhint %}

### Delegates Setup

Select one of the following options:

* **Use any available Delegate**: Harness selects an available delegate at runtime.
* **Only use Delegates with all of the following tags**: Enter the tags of the delegates Harness must use with this connector.

The **Test Delegate Connectivity** list shows the delegates that match your selection. To add a delegate, click **Install new Delegate**.

Click **Save and Continue**.

![Sumo Logic connector delegates setup with the delegate connectivity list](https://173309742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3F2TpHXhur2QtQnORSM9%2Fuploads%2Fgit-blob-1644d2728dfb6ed3ceb29540a12afcf1122480b5%2Fsumo-logic-connector-delegates-setup.png?alt=media)

### Verify Connection

Click **Finish** after the connection test succeeds. The connector is listed in **Connectors** page.

***

## Sample YAML

The following example shows a YAML for the Sumo Logic connector created in this topic.

<details>

<summary>YAML - Sumo Logic connector</summary>

```yaml
connector:
  name: your-sumologic-connector # Replace with a name for your connector
  identifier: yoursumologicconnector # Replace with a unique identifier
  description: ""
  accountIdentifier: youraccountidentifier # Replace with your Harness account identifier
  orgIdentifier: default # Replace with your organization identifier, or remove for account scope
  projectIdentifier: yourprojectidentifier # Replace with your project identifier, or remove for org/account scope
  type: SumoLogic
  spec:
    url: https://api.us2.sumologic.com/ # Replace with the API server URL for your Sumo Logic deployment
    accessIdRef: your-access-id-secret # Replace with a reference to the Harness secret storing your access ID
    accessKeyRef: your-access-key-secret # Replace with a reference to the Harness secret storing your access key
    ignoreTestConnection: false # Set to true only to skip connector preflight checks
```

</details>

For the full connector YAML schema, including how to skip connector preflight checks, go to [Create a connector using YAML](https://developer.harness.io/harness-platform/use-harness-platform/connectors/create-a-connector-using-yaml.md).

***

## Next steps

* [Use delegate selectors](https://developer.harness.io/harness-platform/use-harness-platform/delegates/delegate/manage-delegates/select-delegates-with-selectors.md): Control which delegates can connect to this connector.
* [Add a text secret](https://developer.harness.io/harness-platform/use-harness-platform/secrets/add-use-text-secrets.md): Store the Sumo Logic access ID and key as Harness secrets.
