Skip to content

πŸ‘‚ LoadUP

LoadUP is a uptime monitoring server that can report status of managed servers. It operates by periodly send ICMP or HTTP GET request to target servers. This lightweight approach ensures no agent is needed on the managed server

LoadUP uses a distributed system architecture with an API-Server with many LoadUP-Worker deployed in different geograpihcal areas to report the reachablity of managed server from different locations.

πŸͺ§ LoadUP-CP

LoadUP uses a Web Dashboard as a control plane to declare Target nodes and manage workers. It will Assign a random UUID to each target node.

alt text


This UUID is then placed as the HealthCheck ID of DNS records on EdgeHit Controller

alt text


πŸ’« LoadUP API-Server

API-Server is deployed alongside the CP web Dashboard. The functionality of API-Server is discussed as below:

  • LoadUP-CP connect to the API-Server to declare WorkerNode and TargetNodes.
  • LoadUP-Worker connect to the LoadUP API-Server to report target node status.
  • DNS HealthChecker connect to the LoadUP API-Server to pull target node status.

In order to connect to the api server, the LoadUP-Worker and DNS HealthChecker must both have the API token declared in the .env file.

  • DNS HealthChecker uses user account API token to connect to the API Server.

    alt text

    example .env file
        health_check_api_url=<LoadUP Server Domain>
    health_check_api_key=bb6bc925-b140-4311-96cb-eb47363fd3d9

    Important Note

    make sure changes the API key on .env file after you regenerate the User Account API key as it will invalidate the previous API token


  • LoadUP-Worker uses Server UUID that corespond to the LoadUP-Worker as the API token

    alt text

    example .env file
        health_check_api_url=<LoadUP Server Domain>
    loadup_worker_api_key=f6f94a94-90f0-44ef-820c-37db6ec10fd2


πŸ“¦ LoadUp-Worker

Tip

LoadUp Worker Can Also be deployed in Load-Proxy Instances, as the service port does not conclient and all component in LoadUp-Worker Is packed in docker instance.

LoadUP-Worker are servers that are deployed in different geographical area to query the status of TargetNodes. They perform actions stated as below

  • pulls the config from API-Server for tasks that coresponds to Own UUID
  • perform the preconfigured action such as sending ICMP request to target nodes
  • report the Status of target node periodically to API-Server.