# Derdack EA Integration

Derdack’s enterprise alerting software automates alerting processes and enables a fast, reliable, and effective response to incidents threatening the continuity of services and operations. This is particularly important for 24/7 operations of mission-critical systems and IT.

IT-Conductor supports integration with Derdack Enterprise Alert (Derdack EA), enabling organizations to harness the full potential of collaborative communication alongside efficient IT management. This integration empowers teams to enhance productivity, monitor operations in real-time, and proactively address issues, creating a unified and dynamic work environment.

Our critical alerting software combines four pillars to effectively respond to incidents – automated alert notifications, convenient duty scheduling, ad-hoc collaboration, and anywhere incident remediation.

### Prerequisites

Before configuring a Derdack integration for monitoring in IT-Conductor, follow the instructions below.&#x20;

#### Account Requirements

The user account for accessing the SOAP API can be either a custom Enterprise Alert account or a Windows account synchronized from Active Directory.&#x20;

The account needs to either be assigned the Administrators role or assigned to a user role that has the “Connect to Web Service API” permission. The latter is only supported if your license allows you to customize user roles and permissions.

### Configure Derdack EA Integration in IT-Conductor <a href="#user-content-aseserver-howtoconfigureremotemonitoringofsapasedatabase" id="user-content-aseserver-howtoconfigureremotemonitoringofsapasedatabase"></a>

To configure Derdack EA integration in IT-Conductor, follow the instructions below.

1. Visit [service.itconductor.com](https://service.itconductor.com/) and enter your login credentials.
2. Navigate to **Dashboards → Administrator** to access the **Administrator's Dashboard**.
3. Locate the **Integrations Providers** actions panel and click the title to access the complete list.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fc1u22JyB8WHtCa50IiiH%2Fadministrator-dashboard-integration-providers-click-title.png?alt=media&#x26;token=4fa64ca7-e546-4b3b-ad06-85db1ce15230" alt=""><figcaption><p>Figure 1: Integration Providers Actions Panel in Administrator’s Dashboard</p></figcaption></figure>

4. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fssjl873eKpM8VFPxrooZ%2Fderdack-icon.gif?alt=media&#x26;token=6a22b6ef-68e5-409a-bfc8-2497127af9db" alt="" data-size="line">**Create Derdack EA Integration** to start creating a new connection.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Foe4VWfS3hwM9opsQkup1%2Fintegration-providers-actions-panel-page-derdack.png?alt=media&#x26;token=ff911524-bad7-4584-8bd7-0da77d72a803" alt=""><figcaption><p>Figure 2a: Integration Providers Actions Panel Page</p></figcaption></figure>

Alternatively, you can click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fssjl873eKpM8VFPxrooZ%2Fderdack-icon.gif?alt=media&#x26;token=6a22b6ef-68e5-409a-bfc8-2497127af9db" alt="" data-size="line">**Create Derdack EA Integration** directly from the Administrator’s Dashboard.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FCJz5ItaWMZChP4OpDZde%2Fclick-create-derdack-ea-integration-from-admin-dashboard.png?alt=media&#x26;token=2c69d00e-82b0-4977-b55a-5d95c0d7fec5" alt=""><figcaption><p>Figure 2b: Integration Providers Actions Panel in Administrator’s Dashboard</p></figcaption></figure>

5. Fill out all the necessary information in the **Create Derdack Connection** wizard. Once completed, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to create the connection.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FWcA5dR9kRjrL89eXLTaq%2F01%20new%20connection.PNG?alt=media&#x26;token=0041ea92-cd60-44e7-a772-ef9bd20a937c" alt=""><figcaption><p>Figure 3a: Create Derdack Connection Wizard (Configure Connection Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the integration being configured.
* **Organization** - refers to an administrative structure that defines objects with a common goal or purpose. If you previously created an organization, please select it.
* **Role** - refers to the environment where the integration will be used.
* **Site** - refers to a logical object that describes a particular area or location, depending on the context in which it is used.
* **Gateway** - allows communication between the customer's site network and the IT-Conductor cloud platform. Select the previously configured gateway from the dropdown menu. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Timeout** - refers to the maximum amount of time IT-Conductor will attempt to establish a connection to the server (120 seconds by default).
* **Proxy** - opting for this option allows you to specify the host and port.
* **Scheme** - refers to the web protocol to be used.
* **Host** **Name** - refers to the derdack server hostname.
* **Ping Interval** - refers to the value that ensures the webhook connection remains responsive

6. Provide the account information in the **New Account** screen and click <img src="https://docs.itconductor.com/~gitbook/image?url=https%3A%2F%2F377464071-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXhp08OmU8050PePmMgDt%252Fuploads%252Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%252Fadd.png%3Falt%3Dmedia&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=e62e4a3a&#x26;sv=2" alt="" data-size="line"> to complete the configuration.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fr2tBgBlvdiIBvgS9pHeO%2F02%20new%20account.PNG?alt=media&#x26;token=714a6cc2-cff5-4acb-8425-64c9b69f1f1d" alt=""><figcaption><p>Figure 3b: Create Derdack Connection Wizard (New Account Screen) </p></figcaption></figure>

* **Description** - refers to any relevant information about the user account being added.
* **Application** - refers to the name given to the instance being added.
* **Person** - refers to the name of the IT-Conductor user who is adding the system.
* **User Name** - refers to the created user aligned with the [Account Requirements](#account-requirements).
* **User Password** - refers to the password of the previously created user.
* **Re-type Password** - refers to the same password provided in the **Password** field.

7. Verify that the new connection was added to the **Integration Providers** actions panel.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FYUxPeqPRTsBlqNutYKDu%2F03%20derdack%20connection.PNG?alt=media&#x26;token=7172dc4d-b9b6-424b-9a13-92bdd0b31922" alt=""><figcaption><p>Figure 4: New Derdack Connection</p></figcaption></figure>

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F823AgxpbJZjyBzvmOYQx%2F04%20derdack%20in%20grid.png?alt=media&#x26;token=73a5f7d5-d9a3-4fcf-9269-af4a6a2c02d8" alt=""><figcaption><p>Figure 5: Derdack EA Node in Service Grid</p></figcaption></figure>

{% hint style="info" %}
**Note:** The newly added Derdack EA node will appear in the service grid within 5-15 minutes.
{% endhint %}

### **Monitor Derdack EA Integration in IT-Conductor**

To view the availability and performance metrics of a Derdack EA integration, locate the **Derdack EA** node in the service grid.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FHpEme9oXXsXheczElMRd%2F05%20derdack%20in%20grid.png?alt=media&#x26;token=394523d8-664d-484c-a352-b800977dd6a6" alt=""><figcaption><p>Figure 6: Derdack EA Integration Metrics</p></figcaption></figure>

**Derdack EA Integration Key Metrics**

* **Availability** - refers to the operational state and accessibility of the integration.
* **Heartbeat** - refers to the periodic signal sent to the system, enabling real-time detection of server downtime.
* **Missing Account** - refers to the absence of a required user account or resource within the integration.
* **Retriever Failures** - refer to the errors or issues encountered during the retrieval process of essential data or information within the integration.
* **Failed Events** - refers to notifications or alerts that were not successfully delivered or processed by Derdack EA.

To access a historical view of these metrics, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FA6ze5Z1uu6T4GHNN8sP5%2Fbarsicon.gif?alt=media&#x26;token=2a06e789-5475-4be8-8145-75dc943c3d9e" alt="" data-size="line"> and a pop-up chart will be displayed.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FFXEzse3xGxEi9NWnRTky%2F13%20charts.png?alt=media&#x26;token=bfb7a884-eabb-4164-8cfc-6d73a06ad60d" alt=""><figcaption><p>Figure 7: Failed Events Chart</p></figcaption></figure>

#### Health Explorer

To view a more detailed analysis of metrics and time-synchronized data of the integration, click **Health** from the Derdack EA node view.

You will be redirected to the **Health Explorer** page. From here, you can view one or more synchronized metrics over time, which is helpful when troubleshooting issues.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FD2FbSlIte2ZgigTsPeED%2F06%20health%20explorer%20derdack.png?alt=media&#x26;token=d5e6f068-f272-402a-b39f-88c96ba71fcb" alt=""><figcaption><p>Figure 8: Health Explorer</p></figcaption></figure>

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fu6b9ET54CXLqGqEtW9Rg%2F07%20health%20explorer%20derdack%20pt1.png?alt=media&#x26;token=1f6bc179-06c6-429d-9f06-dbf89a90ece9" alt=""><figcaption><p>Figure 9: Health Explorer Continuation</p></figcaption></figure>

#### Provider Registration

Upon configuring EA integration tasks for registration, two event providers are automatically created and executed. In a case when you switch the EA configuration to a new EA server, you will need to rerun registration tasks.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FyQyGt5o1NhdddMbZMf8P%2F08%20provider%20registration.png?alt=media&#x26;token=9ee83c84-a936-4aa1-ba46-3e17aced1dca" alt=""><figcaption><p>Figure 10: Provider Registration List</p></figcaption></figure>

#### Raised Events

This is the count of alerts or notifications that IT-Conductor sends over to Derdack EA. It gives you an idea of how many issues or triggers have been flagged. You can view this list by clicking **Raised Events** on the service grid.&#x20;

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FPwM0r6kFH5wqj0L3uYhP%2F09%20raised%20events.png?alt=media&#x26;token=d1ba0c77-582e-4ba6-bbbc-505ae98d7600" alt=""><figcaption><p>Figure 11: List of Raised Events</p></figcaption></figure>

#### Failed Events

This is the count of alerts or notifications that were not successfully delivered or processed by Derdack EA. You can view this list by clicking **Failed Events** on the service grid.&#x20;

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FGyYZoUDmlmuSm0KwOsY9%2F10%20failed%20events.PNG?alt=media&#x26;token=39f1e184-7321-4af7-8eee-4c9e3c38a6d9" alt=""><figcaption><p>Figure 12: List of Failed Events</p></figcaption></figure>

**Scheduled Maintenance Events**

To view the scheduled maintenance events for Derdack integrations, click **Events** in the service grid, and a pop-up list of **Scheduled Maintenance Events** will be displayed. You may enlarge the pop-up window to find the option to [create a maintenance event](https://docs.itconductor.com/user-guide/monitoring/general/maintenance-mode/scheduled).

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FWuyVMRLwmx9vFbVAowzP%2F11%20events.png?alt=media&#x26;token=0f3ab681-59cc-4a2c-9972-b3b9f2dfbce0" alt=""><figcaption><p>Figure 13: Schedule Maintenance Events</p></figcaption></figure>

Alternatively, you may click the **Maintenance On** option to immediately set the system to maintenance.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F3WY1v9RSoS6FgjJJl4HC%2F12%20maintenance%20on.png?alt=media&#x26;token=3074d260-20df-4553-bddb-80939e342924" alt=""><figcaption><p>Figure 14: Turn Maintenance Mode On</p></figcaption></figure>

### Video

{% embed url="<https://youtu.be/ajC7X4oyjXE?si=uTkc0kxJUIDC9Dgn>" %}
