> 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-splunk-observability-connector.md).

# Add a Splunk Observability connector

Add a Splunk Observability connector so Harness can fetch SignalFx metrics for verification.

Splunk Observability Cloud, formerly SignalFx, is a cloud-based observability platform that collects and analyzes metrics, traces, and logs from applications and infrastructure in real time. Add a Splunk Observability connector in Harness to let your pipelines query the SignalFx metrics. Harness can then use that data in Continuous Verification to compare metric behavior before and 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 Splunk Observability connector](#add-a-splunk-observability-connector) to a Harness project.
* How to configure the [URL and API token](#credentials) that Harness uses to connect to Splunk Observability Cloud.

***

## Before you begin

* **Splunk Observability account**: Your Splunk Observability URL and an API access token with the authorization scope `API Token`. Go to [Create and manage authentication tokens using Splunk Observability Cloud](https://help.splunk.com/en/splunk-observability-cloud/administer/authentication-and-security/authentication-tokens/org-access-tokens) in the Splunk documentation to create a token.
* **Harness permissions**: Permission to create connectors and secrets in Harness.

***

## Add a Splunk Observability connector

You can add a Splunk Observability 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 **Splunk Observability \[SignalFX]** under **Monitoring and Logging Systems**. The Splunk Observability 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**.

![Splunk Observability connector overview settings](https://173309742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3F2TpHXhur2QtQnORSM9%2Fuploads%2Fgit-blob-6161f13da38466fc896ba06ff0d9b9fa6ca59ac8%2Fsplunk-observability-connector-overview.png?alt=media)

### Credentials

Configure the following settings:

1. In **URL**, enter the URL of your Splunk Observability Cloud environment. Replace `<realm>` with your realm identifier, for example, `us1`. Use one of the following formats:
   * **For API access**: `https://api.<realm>.signalfx.com`
   * **For streaming ingestion**: `https://stream.<realm>.signalfx.com`
2. In **API Token**, 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 Splunk Observability access token.
3. Click **Next**.

![Splunk Observability connector credentials with the URL and API token fields](https://173309742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3F2TpHXhur2QtQnORSM9%2Fuploads%2Fgit-blob-f74878e1beddbd05f2f8e968bdb1bdc3bf6654ef%2Fsplunk-observability-connector-credentials.png?alt=media)

### 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**.

![Splunk Observability 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-b283fbc805344a409bae5f5f0c9fbd9175d33842%2Fsplunk-observability-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 Splunk Observability connector created in this topic.

<details>

<summary>YAML - Splunk Observability connector</summary>

```yaml
connector:
  name: your-splunk-observability-connector # Replace with a name for your connector
  identifier: yoursplunkobservabilityconnector # Replace with a unique identifier
  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: SignalFX
  spec:
    url: https://api.us1.signalfx.com/ # Replace with the API URL for your Splunk Observability realm
    apiTokenRef: your-api-token-secret # Replace with a reference to the Harness secret storing your API token
    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 API token as a Harness secret.
