3. Regional Monitoring

Regional Monitoring allows you to monitor your services from multiple geographic locations. This helps detect regional network issues, ISP restrictions, or latency problems.

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.

---

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

bashCopyEditssh user@your-target-server

Step 2: Download and Run the Installation Script

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

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.

---

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.

---

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.