# SAP Cloud Connector Monitoring

Monitoring the SAP Cloud Connector ensures its availability and timely detection of performance bottlenecks. This facilitates proactive issue resolution, resource optimization, and alignment of the SAP Cloud Connector application with user expectations.

### Prerequisites

Before configuring an SAP BODS system for monitoring in IT-Conductor, follow the instructions below.

#### Account Requirements <a href="#account-requirements" id="account-requirements"></a>

1. Create a new SAP Cloud Connector monitoring account.
2. Assign it with its appropriate authorization level as defined below.

| Role          | Technical Role Name | Authorization                    |
| ------------- | ------------------- | -------------------------------- |
| Administrator | admin or sccadmin   | All operations                   |
| Support       | sccsupport          | Edit log and trace configuration |
| Display       | sccdisplay          | Read configuration               |
| Monitoring    | sccmonitoring       | Read monitoring information      |

### Configure SAP Cloud Connector for Monitoring in IT-Conductor <a href="#configure-sap-cloud-connector-for-monitoring-in-it-conductor" id="configure-sap-cloud-connector-for-monitoring-in-it-conductor"></a>

To configure SAP Cloud Connector monitoring in IT-Conductor, follow the instructions below.

#### Add New SAP Cloud Connector <a href="#add-new-sap-cloud-connector" id="add-new-sap-cloud-connector"></a>

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 **SAP Cloud Connectors** 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%2FehMfIYP8dbIk4wp9EaQQ%2Fadministrator-dashboard-sap-cloud-connector.png?alt=media&#x26;token=9f01c39e-916e-41b3-85be-3c889446f149" alt=""><figcaption><p>Figure 1: SAP Cloud Connectors 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%2Fgit-blob-7f816831472c5030e6dfbcb513035d87da645a67%2Fadd.png?alt=media" alt="" data-size="line"> to start adding a new connector for monitoring.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F67ClS6LTDxUN1hMJq4R6%2Fsap-cloud-connector-actions-panel-page.png?alt=media&#x26;token=1b5fc7ca-d7a3-4c82-b1d4-672082cef06a" alt=""><figcaption><p>Figure 2: SAP Cloud Connectors Actions Panel Page</p></figcaption></figure>

5. Fill out all the necessary information in the **New SAP Cloud Connector** 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 add the connector.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FEmirRCKbR5X7DPg8y5dL%2Fnew-cloud-connector-wizard-new-cloud-connector.png?alt=media&#x26;token=03ee3e3d-f74c-4b0b-8d1c-19d57e8a9025" alt=""><figcaption><p>Figure 3a: New SAP Cloud Connector Wizard (New Cloud Connector Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the connection being created.
* **Organization** - refers to an administrative structure defining objects with a common goal or purpose.
* **Role** - refers to the environment where the connection 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.
* **Scheme** - refers to the web protocol to be used.
* **Host** - refers to the host of the cloud connector server.
* **Connection Timeout** - refers to the maximum time IT-Conductor will attempt to establish a connection to Cloud Connector (300 seconds by default).

6. Provide the new account information in the **New Account** screen and 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 complete the configuration.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FiGhOI6mw73MMqMULprPR%2Fnew-cloud-connector-wizard-new-account.png?alt=media&#x26;token=01d44d88-9ce7-4659-b137-171955a52b5b" alt=""><figcaption><p>Figure 3b: New SAP Cloud Connector Wizard (New Account Screen)</p></figcaption></figure>

* **Description** - refers to any relevant information about the account being created.
* **Application** - refers to the Cloud Connector instance created in Step 3.
* **Person** - refers to the name of the user who is adding the connector.
* **User Name** - refers to the user with the “Administrator” role as listed in [Account Requirements](#inlineextension-account-requirements).
* **User Password** - refers to the password of the user.
* **Re-type Password** - refers to the same password provided in the **User Password** field.

7. Verify if the connector was added to the **SAP Cloud Connectors** actions panel and check its status.

{% hint style="info" %}
**Note:** The status will remain on **Ready** for a few minutes. Refresh the panel if needed. If there are configuration issues, such as incorrect connection parameters or an invalid account, the status will remain **Ready**. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FGx0Q4OSu3wOOo5O8ZbQC%2Flog.gif?alt=media&#x26;token=55a3b985-c68a-4120-a285-2afac310a988" alt="" data-size="line"> to display the logs and troubleshoot. If everything is configured correctly, the status will change to **In Progress.**
{% endhint %}

8. Navigate to the service grid and verify if the system was added under the **SAP Cloud Connectors** nod&#x65;**.**

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

### Monitor SAP Cloud Connector in IT-Conductor <a href="#monitoring-sap-cloud-connector-in-it-conductor" id="monitoring-sap-cloud-connector-in-it-conductor"></a>

To view the availability and performance metrics of a SAP Cloud Connector, locate the **SAP Cloud Connector** 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%2FkY7y9Yy4Gkmp66Gp0M7v%2Fsap-cloud-connector-metrics-service-grid.png?alt=media&#x26;token=cd14345a-f769-4a25-bfd4-66b6a33ea3a1" alt=""><figcaption><p>Figure 4: SAP Cloud Connector View in Service Grid</p></figcaption></figure>

#### SAP Cloud Connector Key Metrics <a href="#sap-cloud-connector-key-metrics" id="sap-cloud-connector-key-metrics"></a>

* **Availability** - refers to the operational state and accessibility of the SAP Cloud Connector instance.
* **Connection Failures** - refer to the events where attempts to establish a connection are unsuccessful.
* **Heartbeat** - refers to the periodic signal sent to the system, enabling real-time detection of system downtime.
* **Memory: Heap Total** - refers to the total amount of heap memory allocated to the SAP Cloud Connector process.
* **Memory: Physical Free** - refers to the amount of physical memory that is currently available and unused.
* **Memory: Physical Used** - refers to the amount of physical memory currently utilized by the system.
* **Missing Account** - shows if the SAP Cloud Connector has a missing or wrong account configured in ITC.
* **Retriever Failures** - shows if ITC failed to retrieve SAP Cloud Connector data.

{% hint style="info" %}
**Note:** All metrics will not show data when a system is unavailable.
{% endhint %}

To access a historical view of each of these metrics, click <img src="https://docs.itconductor.com/~gitbook/image?url=https:%2F%2F377464071-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FXhp08OmU8050PePmMgDt%252Fuploads%252F5WqsRtSeSZXYOiW2YXbk%252Fmetric-history-icon.gif%3Falt=media%26token=ef41e39f-428e-4fbd-9d2f-ac6da2caa19c&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=7ed0177f7265e0f4a0f645927183092b94d564d0906ed254a3d77bb886709c75" 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%2FpdmxRomjETsI3IwroxZ2%2Fsap-cloud-connector-service-grid-availability-chart.png?alt=media&#x26;token=a5b0e733-86ba-4111-bd39-6ee824276bd3" alt=""><figcaption><p>Figure 5: SAP Cloud Connector Availability Chart in Service Grid</p></figcaption></figure>

#### Sub-Accounts in Service Grid <a href="#sub-accounts-in-service-grid" id="sub-accounts-in-service-grid"></a>

The expanded view of sub-accounts displays the sub-accounts associated with the Cloud Connector.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FYVAw5Eh9AvLFF9LKWo9r%2Fsap-cloud-connector-subaccounts-service-grid.png?alt=media&#x26;token=736f2cc4-e5a4-4a81-b254-877cb08fe2c3" alt=""><figcaption><p>Figure 6: SAP Cloud Connector Sub-accounts in Service Grid</p></figcaption></figure>

Expand further into the sub-account to view the **Certificate**, **Cloud to On-Prem** and **On-Prem to Cloud** virtual hosts, and **Tunnels**.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FfGUw5e5XA78QQjxTWH4O%2Fsap-cloud-connector-subaccount-certificate-hosts-tunnels.png?alt=media&#x26;token=006a2489-e2fe-4ef4-bb68-70ec27d90d4d" alt=""><figcaption><p>Figure 7: Sub-account Certificate, Virtual Hosts, and Tunnels in Service Grid</p></figcaption></figure>

#### Sub-Accounts Key Metrics <a href="#sub-accounts-key-metrics" id="sub-accounts-key-metrics"></a>

* **Certificate Days to Expiration** - refers to the number of days remaining before a certificate expires.
* **Virtual Host and Resource Calls**
  * **Calls** - refers to the total number of calls or requests.
  * **Received** - refers to the total number of bytes received through a call or request.
  * **Calls Sent** - refers to the total number of bytes sent back as a response.
* **Tunnel State** - refers to the connection state of the tunnel. The state is either Connected, ConnectFailure, or Disconnected.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F9JS8SGlYTM8lV3diwtZG%2Fsap-cloud-connector-subaccounts-metrics.png?alt=media&#x26;token=eb2ca543-d6aa-4ee7-b861-b5be29078dd8" alt=""><figcaption><p>Figure 8: SAP Cloud Connector Monitored Metrics for Sub-Accounts</p></figcaption></figure>

### Video

{% embed url="<https://youtu.be/HcuEGlT_fLw>" %}