Monitor

The Monitor is a distributed monitoring probe that executes checks, collects performance data, and reports results. Deploy multiple instances across your infrastructure for distributed monitoring.

Overview

Service Management

CLI Commands

# Install as service and register with the Webserver
monitor install <webserver_ip>:<port>

# Re-register with the Webserver (e.g., after IP change)
monitor register <webserver_ip>:<port>

# Migrate to a new Webserver (regenerates the certificate, re-registers)
monitor migrate <webserver_ip>:<port> <jwt_token>

# Start / Stop / Restart the service
monitor start
monitor stop
monitor restart

# Run in foreground (Docker or debugging)
monitor run

# Remove the service
monitor uninstall

# Display help
monitor help

During install, the Monitor:

1. Creates the directory structure
2. Generates RSA key pair and TLS certificates
3. Sends a self-registration request to the Webserver
4. Uploads its TLS certificate for mTLS verification

Configuration

The monitor.json file is located in the same directory as the executable:

{
  "name": "probe1",
  "port": "8051",
  "webserver": "192.168.1.100:8050",
  "integratorEndPoint": "",
  "location": "Paris",
  "description": "Production monitoring probe",
  "logLevel": "info",
  "concurrencyLimit": "100",
  "dataRetention": "336",
  "backupInterval": "24",
  "nbDaysBackup": "336",
  "autoThreshold": "true"
}

Core Settings

Browser Configuration (for Web UI / EUM Monitors)

Auto-Thresholding

The Monitor can automatically calculate performance thresholds based on historical data using statistical analysis (standard deviation multipliers):

A nightly job (02:00) recomputes thresholds as mean + (multiplier * stddev) over successful executions of enabled monitors only. Ping monitors also get jitter thresholds (jitterThreshCri/Maj/Min). See Monitor Configuration → Auto-Thresholding for the full formula and tuning guidance.

Vault Integration

Log Rotation

Directory Structure

<install_dir>/
├── monitor(.exe)            # Executable
├── monitor.json             # Service configuration
├── config/
│   ├── sec/                 # RSA keys for JWT
│   └── ssl/                 # TLS certificates for mTLS
├── data/                    # Monitor definition files (JSON)
├── dbs/                     # embedded key-value databases (one per type)
│   ├── exec.db              # Web UI / EUM monitors
│   ├── url.db               # HTTP/HTTPS URL monitors
│   ├── api.db               # REST API monitors
│   ├── tcp.db               # TCP port monitors
│   ├── ping.db              # ICMP ping monitors
│   ├── nslookup.db          # DNS lookup monitors
│   ├── db.db                # Database query monitors
│   ├── sys.db               # System metrics monitors
│   ├── snmp.db              # SNMP monitors
│   ├── chart.db             # Chart/performance data
│   ├── monitor.db           # General monitor data
│   ├── metrics.db           # Probe self metrics (CPU, memory)
│   ├── host.db              # Host inventory data
│   ├── device.db            # Device inventory data
│   └── backup/              # Automated backups
├── log/                     # Rotated log files
├── scripts/                 # Custom scripts for monitors
├── actions/                 # Action scripts (notifications, remediation)
├── exec/                    # Platform-specific executables (webdrivers)
└── export/                  # Data exports

Monitor Types

1. Web UI / EUM (End User Monitoring)

Database: exec.db

Executes multi-step user journeys using Selenium WebDriver. Supports Chrome, Firefox, and Edge browsers.

Capabilities:

• Multi-step transaction recording (via MNS IDE or Selenium IDE)
• Screenshot capture on each step
• Video recording of the entire execution
• HAR (HTTP Archive) file capture
• Individual transaction timing with thresholds
• TOTP (Time-based One-Time Password) support for 2FA (RFC 6238 — 6 digits / 30 s / SHA-1)
• Proxy configuration
• Visual similarity checking

See the dedicated EUM Monitor page for the full specification (TOTP/Okta compatibility, key-vault integration, script functions).

MNS IDE Script Functions:

mnsStartTransaction("Login Page", 30, 5000, 3000); // name, timeout, critical_ms, major_ms
driver.findElement(By.id("username")).sendKeys("user");
driver.findElement(By.id("password")).sendKeys("pass");
driver.findElement(By.id("submit")).click();

2. HTTP/HTTPS URL

Database: url.db

Simple HTTP GET checks with detailed timing metrics.

Metrics collected:

• DNS lookup time
• TCP connection time
• TLS handshake time (with TLS version detection)
• Server processing time
• Content transfer time
• Total response time
• HTTP status code
• Content length
• SSL certificate expiry date

Additional features:

• Response body pattern matching
• Status code validation
• Certificate expiry checking and alerting

3. REST API

Database: api.db

Full API endpoint monitoring with custom HTTP methods, headers, and body.

Supported methods: GET, POST, PUT, DELETE

Features:

• Custom request headers
• Request body configuration
• Response body pattern matching
• Response time measurement
• Status code validation

4. TCP Port

Database: tcp.db

TCP port connectivity checks.

Metrics:

• Connection success/failure
• Connection time
• Destination IP resolution

5. ICMP Ping

Database: ping.db

ICMP Echo Request/Reply for network reachability testing.

Metrics:

• Minimum / Maximum / Average latency
• Jitter (standard deviation)
• Packets sent / received / lost
• Packet loss rate

6. DNS Lookup (Nslookup)

Database: nslookup.db

DNS resolution monitoring.

Metrics:

• DNS lookup time
• Response validation

7. SNMP

Database: snmp.db

SNMP polling for network device monitoring.

Features:

• SNMP v1/v2c/v3 support
• OID queries with MIB expressions
• Delta calculations between polls
• Expression evaluation on collected values

8. Database Query

Database: db.db

Database connectivity and query execution monitoring.

Supported databases:

• MySQL
• Microsoft SQL Server (MSSQL)

Metrics:

• Query execution time
• Result validation
• Connection time

9. System Metrics

Database: sys.db

Self-monitoring of the probe host.

Metrics:

• CPU usage percentage
• Memory usage
• Disk usage

Scheduling

Each monitor type has its own independent cron scheduler (using robfig/cron/v3). This isolation ensures that a slow monitor type cannot block other types.

Predefined Schedules

Concurrency Control

A global semaphore limits the number of concurrent monitor executions (configurable via concurrencyLimit, default: 100). Each execution acquires a slot before starting and releases it when complete, preventing resource exhaustion on the probe host.

Alerting

The Monitor can send alerts directly without needing an Integrator.

Notification Channels

Alert Triggers

Custom Actions

Action scripts can be placed in the actions/ directory and configured per monitor. They execute automatically on failure or status change with a configurable timeout.

REST API Endpoints

Authentication

Monitor Management

Data Retrieval

Type-Specific Creation

Configuration

Data Storage

Each monitor type stores results in its own embedded key-value database with multiple buckets per monitor:

All timestamps are stored as Unix milliseconds (epoch in ms).

Data is automatically purged based on the dataRetention setting (default: 336 hours / 14 days).

See also

• Monitor Configuration — complete settings reference
• Monitor HTTP API — full API documentation
• Monitor Operations — UI guide for managing monitors
• Platform Overview — how the Monitor fits into the architecture
• Exception Running a Monitor — troubleshooting monitor errors

Translations

• fr: Monitor