Monitoring API Layer

A single API surface for both global workers and local agents

Inside `api.signal.ge`, two architectural pipelines are strictly isolated: external region workers interact via a structural lease/results allocation model, while localized system daemons target dedicated metrics and private network endpoints.

Public Routes /monitoring/v1/*
Agent Routes /system-agent/v1/*
Authentication Bearer API Key
Worker Engine Lease + Results + Heartbeat

API Architectural Boundaries

Our API core fully maps perimeter availability tracking alongside comprehensive internal private network telemetry ingestion.

Global Monitoring Workers

The worker securely provisions its active region and engine version, requests dynamic execution batches, and returns network logs.

Lease/Results Protocol

Monitors are temporarily locked for routing overhead, updating system uptime states, response logs, and telemetry upon completion.

System Daemon Telemetry

The agent data gateway safely routes machine capacity specs and core resource usage arrays right into the control panel.

Private Agent Allocation

A localized daemon securely fetches task items designated solely to its token scope and tests environments hidden behind firewalls.

Permission Scope Mapping

Route permissions map project application credentials directly to atomic `system.metrics.write` and `system.monitoring.run` scopes.

Outage Pipeline Triggers

Result parsing at the API layer natively triggers the active incident lifecycle framework and manages down-range alert routing.

Primary API Endpoints

Core transport methods and resource paths provisioned for infrastructure integration.

Method Path Description
POST /api/monitoring/v1/lease A global region worker requests its next concurrent batch of monitors
POST /api/monitoring/v1/results The worker returns status logs, exact response durations, and HTTP code verifications
POST /monitoring/v1/heartbeat Dispatches a routine worker liveness signal back to `api.signal.ge`
POST /api/system-agent/v1/metrics The background daemon ships host machine resource utilization payloads
POST /api/system-agent/v1/monitoring/lease The agent requests monitors pinned specifically to its isolated network scope
POST /api/system-agent/v1/monitoring/results The agent returns localized execution states for internal network components

Payload Request Format

{
"region": "ge-tbilisi",
"worker_id": "worker-01",
"version": "1.0.9",
"limit": 50
}

Architectural Advantages

  • External global workers and local system daemons retain completely isolated operational concerns
  • Monitor execution states are handled centrally, mitigating telemetry data corruption or local loss
  • Public perimeter checking and internal network monitoring run seamlessly side by side within a single project scope
  • Extensible design: Based on your specific workflow requirements, any custom endpoint functionality or tailored tracking module can be integrated into the API on demand.

Evaluated the API plane? Let's take the next operational step.

If private infrastructure auditing is your core target, move forward to our cross-platform agent deployment guide.

Platform ecosystem

Signal.ge brings the management panel, powerful API, and agents together

One workspace for a flexible control panel, developer-friendly API, global external checks, and local agents for monitoring infrastructure of any complexity.

Intuitive management
A unified and transparent ecosystem for centralized control of digital assets, proactive incident analysis, and status pages.
High-performance architecture
A low-latency data processing core that provides secure, scalable, and continuous synchronization of monitoring workflows.
Global perimeter
A geo-distributed monitoring network that continuously checks service availability and infrastructure stability from the outside.
Internal infrastructure
Lightweight independent agents for auditing closed and isolated networks, collecting hardware telemetry, and tracking system resources.
Smart notifications
Instant escalation and filtering of critical incidents through multiple channels, so the notification reaches the right team member.
uBill.ge
A billing system and SMS service in one workspace for managing subscribers, payments, balances, and customer communication.
Back to top