> For the complete documentation index, see [llms.txt](https://docs.checkcle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.checkcle.io/main-features/uptime-monitoring/3.-regional-monitoring.md).

# 3. Regional Monitoring

### **1. Access the Regional Monitoring Dashboard**

1. In **CheckCle App**, go to the **left sidebar**.
2. Click **Regional Monitoring**.
   * Here you will see the list of all **regional monitoring agents**.
   * Each agent represents a **server or node** running the monitoring script in a specific region.

***

### **2. Create a Regional Monitoring Agent**

1. In the **Regional Monitoring dashboard**, click **+ New Regional Agent**.
2. Fill in the following details:
   * **Agent Name:** A descriptive name (e.g., “Singapore Agent” or “US-East Node”).
   * **Region:** Select the location where this agent will be deployed.
   * **Description (optional):** Add any notes for identification.
3. After creating the agent:
   * A **registration script** will be generated for you.
   * This script is used to connect your regional server to CheckCle.

<figure><img src="/files/UgB5xVUKJXprBsxNJoaI" alt=""><figcaption></figcaption></figure>

***

### **3. Deploy the Regional Agent on the Target Server**

To start monitoring from a specific location, deploy the agent on a **Linux server** in that region:

#### **Step 1: SSH into Your Target Server**

```bash
bashCopyEditssh user@your-target-server
```

#### **Step 2: Download and Run the Installation Script**

* Copy the script generated by CheckCle (example below):

```bash
curl -fsSL https://cdn.checkcle.io/scripts/regional-agent.sh | sudo bash -s -- --region-name="test" --agent-id="agent_0ai869j8" --agent-ip="192.168.1.1" --token="yfjsh9nz7cfw09nspcoh5" --pocketbase-url="https://demo.checkcle.io"
```

**Notes:**

* The `--agent-key` is unique to the agent you created.
* This script will:
  1. Download the monitoring agent binary.
  2. Register the agent with your CheckCle instance.
  3. Start the agent as a background service.

#### **Step 3: Verify Agent Registration**

* After the script runs successfully, return to the **Regional Monitoring dashboard**.
* Your new agent should appear as **Online**.

<figure><img src="/files/36mdoEJrY9i3q6iXDhSC" alt=""><figcaption></figcaption></figure>

***

### **4. Assign Regional Agents to Services**

Once the regional agent is online:

1. Go to **Uptime Monitoring** → **New Service** or edit an existing service.
2. Scroll to **Regional Monitoring**.
3. Enable the toggle and select which **regional agents** should monitor this service.
4. Save your changes.

Now your service will be checked from multiple locations.

<figure><img src="/files/EzEGrGWIXXvyT58JUXhC" alt=""><figcaption></figcaption></figure>

***

### **5. Benefits of Regional Monitoring**

* Detect **location-specific outages** (e.g., ISP block in one country).
* Measure **response time** and **latency** from different regions.
* Provide **more reliable uptime reporting** for global users.