# Deviations

## What is a Deviation?

A **deviation** occurs when a service resource fails to reach its target state after the service is enabled. When you [enable a service](https://docs.cybus.io/1-11-0/documentation/services/setting-up-and-configuring-services/enabling-services), its resources should transition from disabled to enabled (or to another specified target state defined in the service commissioning file). The service commissioning file contains detailed specifications of all resources and their required states for proper service functionality.

However, various issues (such as hardware failures, network problems, or configuration errors) can prevent resources from achieving their intended states. When this happens, the affected service is marked as **deviated**.

## Identifying Deviated Services

Cybus Connectware provides multiple ways to identify and investigate deviations:

### Deviation Notifications

When a deviation occurs, a pop-up notification appears in the Admin UI. This notification provides an immediate alert that one or more services are not functioning as expected.

<figure><img src="https://3526354945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrCPVzPlizXFgeCsIL7jH%2Fuploads%2Fgit-blob-51f9ba64bccbceaaa8ee354096a32cc951fa15c9%2Fdeviation-popup.png?alt=media" alt="Deviation notification popup"><figcaption><p>Deviation notification</p></figcaption></figure>

* To view all deviated services, click the down arrow in the notification panel. This expands the list to show all services currently experiencing deviations.

### Deviation Indicators

Deviation status is also displayed in multiple locations throughout the Admin UI:

* In the [Service Overview](https://docs.cybus.io/1-11-0/documentation/services/service-overview)
* Within the [Service Details view](https://docs.cybus.io/1-11-0/documentation/services/service-details-view) for individual services
* In [resource](https://docs.cybus.io/1-11-0/documentation/services/service-resources-view) lists for affected services

### List of Deviations

When you click on a deviation warning message, the system displays a detailed list of resources whose actual states differ from their expected states:

<figure><img src="https://3526354945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrCPVzPlizXFgeCsIL7jH%2Fuploads%2Fgit-blob-a87d443d7c956a72a7a26b7c6b2b09118ef91155%2Fdeviation-details.png?alt=media" alt="Detailed view of deviated resources"><figcaption><p>Deviated resources showing state discrepancies</p></figcaption></figure>

## Examining Deviated Resources

For a comprehensive analysis of which specific resources are causing the deviation:

1. Click on the deviated service name in the services list
2. Navigate to the **Deviations** tab for that service
3. Review the detailed comparison between expected and actual states for each resource

<figure><img src="https://3526354945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrCPVzPlizXFgeCsIL7jH%2Fuploads%2Fgit-blob-8c9bd4c4ee83d4112a1406263f5160e967dd677e%2Fdeviation-tab.png?alt=media" alt="Deviations tab showing resource status"><figcaption><p>Deviations tab displaying expected vs. actual status for each deviated resource</p></figcaption></figure>

## Resolving Deviations

When addressing deviations, focus on:

1. Identifying the root cause (hardware, network, configuration)
2. Resolving the underlying issue
3. Re-enabling the service to verify the resolution. See [Enabling Services](https://docs.cybus.io/1-11-0/documentation/services/setting-up-and-configuring-services/enabling-services).

{% hint style="info" %}
Persistent deviations may require additional troubleshooting or consultation with your system administrator.
{% endhint %}