> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Adapter degraded status

> How to implement and recognize the degraded connection state for adapters in Itential Platform.

## Degraded connection

The `degraded` status is an additional adapter state alongside the `online` (connected) and `offline` (disconnected) statuses. This state is intended for adapters like adapter-nso and others that have multiple connection types.

Some scenarios where the degraded state applies include:

* The connection is not fully up or fully down.
* One method of communication for an adapter has been disconnected, but another is still active.
* The adapter is connected, but with an unstable connection.
* Some functions related to a mode of communication fail to respond.

## Emit degraded events

Add the following code to instances where you would like to send the adapter to the degraded state:

```javascript
this.emit("DEGRADED", {
    reason: 'Reason adapter is degraded (will appear on system page)'
});
```

Add the following code to instances where the adapter is no longer degraded and the state should be removed — for example, if a second method of communication comes back online, the connection stabilizes, or a specific call succeeds:

```javascript
this.emit("FIXED", {
    reason: 'Optional'
});
```

## Recognize a degraded adapter in Admin Essentials

#### Start Itential Platform and Adapter NSO

Start both Itential Platform and Adapter NSO.

#### Connect with default credentials

Connect them using the default `admin` username and `admin` password.

![](/_fern-img/8fcfb8a406fa5305315577d1fa15db7eb3e05ee716701f4fb50ff5bf3461b1a6.webp)

#### Verify initial connection status

Check the connection status from **Admin Essentials** → **Profiles** → **Adapters**. Status should show as "Running" and connection as "Online".

![](/_fern-img/409b60d3bd7b2862198018e9d23cac493db58fed1b979daad4991fb3e139b44b.webp)

#### Create a new user in NSO

Create a new user in NSO with the name `client`.

![](/_fern-img/7dc99a5dec807cf0b80bbb197591675e4ed8c9567eccfb8b02fa70ef5f656674.webp)

#### Update adapter credentials

Change the Adapter NSO properties credentials to the newly created user (username and password).

![](/_fern-img/59d39ee48266e5549db77d14e65285ccb774a44b2513d077087474fb2c925b09.webp)

#### Verify updated connection status

Go back and check the connection status from **Admin Essentials** → **Profiles** → **Adapters**. Status should show as "Running" and connection as "Online".

![](/_fern-img/79a236ca2097d05d45aad25415ce4aef529da0873bef2109352ea7b8ae4fff44.webp)

#### Delete the client user from NSO

Go to NSO and delete the `client` user.

![](/_fern-img/e80d103a1a34d9553d86669fa70480242ffaedde70585bb54f359dcb151dce0c.webp)

#### Confirm degraded status

Check the connection status from **Admin Essentials** → **Profiles** → **Adapters**. Status should now show as "Running" and connection as "Degraded".

![](/_fern-img/2c6eac56fc72f4882beaf77e2fa1e5cdc2a67666c67fe94cda140b5f1a7d84ef.webp)