# URL Monitoring

URL monitoring plays a critical role in ensuring the availability and performance of web services and applications across different geographic locations. This functionality enables users to specify which URLs to monitor and designate monitoring locations worldwide. It also ensures comprehensive visibility into the accessibility and responsiveness of critical online resources, facilitating proactive maintenance and enhancing user experience.

### Configure URL Monitoring in IT-Conductor

To configure URL monitoring in IT-Conductor, follow the instructions below.

#### Add New URL for Monitoring

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 **URL Monitoring Locations** 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%2FsGWWHiZNLQiWhpj5qrGa%2F01%20administrator&#x27;s%20dashboard.png?alt=media&#x26;token=efbd3a6d-ef81-4ad6-a951-27be9f877b7e" alt=""><figcaption><p>Figure 1: URL Monitoring Locations Actions Panel in Administrator's Dashboard</p></figcaption></figure>

4. Click the **New URL Monitoring** button to start adding a URL.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F93s09U4D0QIeNKHLDxA0%2Furl-monitoring-actions-panel-page.png?alt=media&#x26;token=fd3efd3b-28f2-4622-a9b7-663781e6699a" alt=""><figcaption><p>Figure 2: URL Monitoring Actions Panel Page</p></figcaption></figure>

5. Fill out all the necessary information in the **New URL Monitoring** 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 URL.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fuyf7WX2B1iu2PLMhyLBx%2F03%20add%20a%20new%20url%20monitoring.PNG?alt=media&#x26;token=953bd100-7f4c-4d09-a673-fcd0ba4f7a75" alt=""><figcaption><p>Figure 3: New URL Monitoring Wizard (New URL Monitoring Location Screen)</p></figcaption></figure>

* **Name** - refers to an identifier for the URL being added.
* **Description** - refers to any relevant information about the URL being added.
* **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 URL 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. See [Gateway Setup](https://docs.itconductor.com/user-guide/setup/gateway-setup) for more details.
* **Scheme -** specifies the protocol used for the URL (e.g., HTTP or HTTPS).
* **Host** - refers to the host of the URL being added.
* **Port** - refers to the port number used to access the URL being added.
* **Connection Timeout** - refers to the maximum time allowed to establish a connection before timing out. By default, this is set to 300 seconds.
* **Enforce Certificate** - if checked, it determines whether the monitoring should enforce SSL certificate validation for HTTPS URLs.

6. A new URL Monitoring location will be added to the actions panel. The status will remain on **Ready** until an HTTP probe is added.
7. Click on the new URL name, and then click on the <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fijv0eWWb2QMCdQT2TcnL%2Fprobeicon.gif?alt=media&#x26;token=ce31ae14-9e90-43ce-b6ae-b6bbe34381df" alt="" data-size="line">**HTTP Probes**. Alternatively, you can click ![](https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FyGm5t132ZvXjl6V4X25d%2FiconShow.gif?alt=media\&token=d5f127a9-9701-4728-b36f-24dbe2016447) and then <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fijv0eWWb2QMCdQT2TcnL%2Fprobeicon.gif?alt=media&#x26;token=ce31ae14-9e90-43ce-b6ae-b6bbe34381df" alt="" data-size="line">**Probes.**

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FiIHkzzchCMu4vk2FsK0n%2F04%20http%20probes.png?alt=media&#x26;token=5c8471b3-c2ad-46c0-bd79-f5c15837d7f9" alt=""><figcaption><p>Figure 4: Newly Added URL Monitoring in the Actions Panel Page</p></figcaption></figure>

8. Click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FYwPAoldzUtpcw5D1Hg3g%2Fhttp%20probe.gif?alt=media&#x26;token=2abfcc01-1bc3-48c1-b343-6d82c797fa2c" alt="" data-size="line"> **Create HTTP Probe** to create a new HTTP probe.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FLPfHuxOHVdsl8yejtQrd%2F05%20create%20hhtp%20probe.png?alt=media&#x26;token=469d37cc-0443-4fbb-97cb-6788070e2c96" alt=""><figcaption><p>Figure 5: Probes Actions Panel Page</p></figcaption></figure>

9. Fill out all the necessary information in the **Create HTTP Availability Probe** wizard. Once completed, click the **Finish** button to create the probe.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FoDVMEY2UgkbHVqvvGZTW%2F06%20create%20http%20probe%20pt2.png?alt=media&#x26;token=585ae136-6fd4-4c71-9e8c-e829a5bf6a47" alt=""><figcaption><p>Figure 6: Create HTTP Availability Probe Wizard</p></figcaption></figure>

* **Name** - refers to a descriptive name for the probe.
* **Description** - refers to any relevant information about the probe being added.
* **Owner** - refers to the user who's adding the new probe.
* **Application** - refers to the name given to the URL in the previous step.
* **Schedule** - sets the frequency or timing for executing the monitoring. You may choose from one of the schedules previously created in IT-Conductor. See [How to Define Operating Schedules](https://docs.itconductor.com/reporting/scheduling-reports#reportscheduling-definingandoperatingschedules) for details.
* **Planned Start Time** - refers to the scheduled start time for the monitoring task.
* **Time Windows Begin** - refers to the beginning of the time window during which the monitoring can be executed.
* **Time Windows End** - refers to the end of the time window during which the monitoring can be executed.
* **Repeat** - specifies that the task should be repeated or executed only once if checked.
* **Repeat Interval** - refers to the time interval between repeated executions of the monitoring task. By default, this is set to 15 minutes.
* **HTTP Method** - determines the HTTP method for the request (Get, Post, Delete, Head, Put).
* **URL** - refers to the URL of the web service or application to be monitored.
* **Preserve Query** - when enabled, this option ensures that the full query string in the specified URL is retained during the probe request.
* **MIME Type** - defines the expected MIME type of the response from the URL.
* **Allowed Status** - specifies the HTTP status codes considered acceptable for a successful response. By default, this is set to 401.
* **Follow Redirect** - determines that the monitoring should follow HTTP redirects if checked.
* **Parse Results** - determines whether to parse and analyze the content of the response.

10. Wait for the HTTP Probe status to turn to **Waiting.**

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FaamNttBvKYC6iXDo844H%2F07%20new%20probe.png?alt=media&#x26;token=9a6ffb5d-b0f7-40bb-a9a8-ddd77ccee5e7" alt=""><figcaption><p>Figure 7: Newly Added HTTP Probe</p></figcaption></figure>

11. Navigate back to the URL Monitoring Actions Panel Page. The created Monitoring Location should be in the **In-Progress** state.
12. Navigate to the service grid and verify if the URL and probe were added under the **URL Monitoring** node. Alternatively, you can click ![](https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FyGm5t132ZvXjl6V4X25d%2FiconShow.gif?alt=media\&token=d5f127a9-9701-4728-b36f-24dbe2016447) and then <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FA8B5mnBPn826fjDBheIX%2Fgrid%20icon.gif?alt=media&#x26;token=7f6f9b00-8cb1-4efb-b5c2-aea856ba3065" alt="" data-size="line"> **Grid** to navigate to the URL Monitoring service grid.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FVPI5lOtBBeR6s2dr3UPh%2Fgrid.png?alt=media&#x26;token=3b0b5581-a9e8-46a3-83b9-95967138bf02" alt=""><figcaption><p>Figure 8: Newly Added URL In Progress</p></figcaption></figure>

{% hint style="info" %}
**Note:** Please allow 5-15 minutes for the new URL and probe to show in the service grid.
{% endhint %}

### Monitor URL Locations in IT-Conductor

To view the availability, response time, and status code metrics of a monitored URL, locate the **URL Monitoring** 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%2FchbaEIlkOJ0340gdwzuD%2F08%20url%20monitoring.png?alt=media&#x26;token=db55ea29-ffdd-4370-bc88-3a650426cc3c" alt=""><figcaption><p>Figure 9: URL Monitoring Node View in the Service Grid</p></figcaption></figure>

#### **URL Monitoring Key Metrics**

* **Connection Failures** - refer to the events where attempts to establish a connection are unsuccessful.
* **Missing Account** - refers to the absence of a required user account or resource within the URL location.

#### **HTTP Probe Key Metrics**

* **Availability** - refers to the operational state and accessibility of the HTTP probe.
* **Response Time** - refers to the duration (in msec) taken for the webserver to respond to the request.
* **Status Code** - indicates the HTTP status code returned by the server, providing information on the success or failure of the request.

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

To access a historical view of each of these metrics, click <img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F5WqsRtSeSZXYOiW2YXbk%2Fmetric-history-icon.gif?alt=media&#x26;token=ef41e39f-428e-4fbd-9d2f-ac6da2caa19c" 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%2FgC0noHxVliur4MFtd0qN%2F09%20url%20monitoring%20pt2.png?alt=media&#x26;token=dad3efea-b053-4d60-ba61-868ce90c5e55" alt=""><figcaption><p>Figure 10: Availability Chart in Service Grid</p></figcaption></figure>

### Video

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.itconductor.com/user-guide/monitoring/general/url.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
