This is documentation for Test, Monitor, and Visualize Geospatial APIs 1.0.0, which is no longer actively maintained.

For up-to-date documentation, see the latest version (1.1.0).

Version: 1.0.0

On this page

Keep your APIs running smoothly with Quetzly Validator's monitoring feature. Set up continuous monitoring of your critical endpoints to track uptime, performance, and view issues before they impact your users.

What is API Monitoring? [​](/content/docs/1.0.0/desktop/monitor/#what-is-api-monitoring "Direct link to What is API Monitoring?"/index.html)

API monitoring is the continuous checking of your endpoints to ensure they:

  • Respond successfully: Return expected HTTP status codes
  • Perform adequately: Meet response time requirements
  • Stay available: Remain accessible when needed
  • Function correctly: Return expected data formats and content

Note: at the moment only basic monitoring is performed on APIs to get returned HTTP status. More monitoring information and features are planned for future releases.

Accessing the Monitor Interface [​](/content/docs/1.0.0/desktop/monitor/#accessing-the-monitor-interface "Direct link to Accessing the Monitor Interface"/index.html)

  1. Click the Monitor icon in the left sidebar
  2. The Monitor panel displays:
    • Add API Endpoint: Configure new endpoints for monitoring
    • Monitoring Interval: Set check frequency
    • Monitor Table: View status of all monitored endpoints

Setting Up Endpoint Monitoring [​](/content/docs/1.0.0/desktop/monitor/#setting-up-endpoint-monitoring "Direct link to Setting Up Endpoint Monitoring"/index.html)

Adding API Endpoints [​](/content/docs/1.0.0/desktop/monitor/#adding-api-endpoints "Direct link to Adding API Endpoints"/index.html)

Step 1: Add Endpoint URL [​](/content/docs/1.0.0/desktop/monitor/#step-1-add-endpoint-url "Direct link to Step 1: Add Endpoint URL"/index.html)

  1. Enter the API endpoint URL in the "Enter API Endpoint URL" field
  2. Examples of endpoints to monitor:
# WMS GetCapabilities
https://example.com/geoserver/wms?service=WMS&request=GetCapabilities

# REST API health check
https://api.example.com/v1/health

# ArcGIS service status
https://services.arcgis.com/example/arcgis/rest/services/layer/MapServer

# WFS service availability
https://example.com/geoserver/wfs?service=WFS&request=GetCapabilities
  1. Click "Add" to add the endpoint to your monitoring list

Step 2: Configure Monitoring Interval [​](/content/docs/1.0.0/desktop/monitor/#step-2-configure-monitoring-interval "Direct link to Step 2: Configure Monitoring Interval"/index.html)

Set Check Frequency:

  1. Enter a number in the "Interval Time" field

  2. Select the time unit from the dropdown:

    • seconds: For high-frequency monitoring (use sparingly)
    • minutes: Most common for active monitoring
    • hours: For less critical services
    • days: For basic availability checks

  3. Click "Save" to apply the monitoring interval to all endpoints

Monitor Configuration Best Practices [​](/content/docs/1.0.0/desktop/monitor/#monitor-configuration-best-practices "Direct link to Monitor Configuration Best Practices"/index.html)

Choosing Monitoring Intervals [​](/content/docs/1.0.0/desktop/monitor/#choosing-monitoring-intervals "Direct link to Choosing Monitoring Intervals"/index.html)

Consider these factors:

  • Service criticality: More critical = more frequent checks
  • Service stability: Unstable services may need frequent monitoring
  • Resource usage: Frequent checks consume more resources
  • Provider limits: Respect API rate limits and terms of service

Endpoint Selection [​](/content/docs/1.0.0/desktop/monitor/#endpoint-selection "Direct link to Endpoint Selection"/index.html)

Recommended endpoints to monitor:

  • ✅ Service health/status endpoints: Dedicated health check URLs
  • ✅ GetCapabilities requests: For WMS/WFS service availability
  • ✅ Root service endpoints: Main service entry points
  • ✅ Authentication endpoints: Login and token services
  • ✅ Critical data endpoints: Your most important data sources

Avoid monitoring:

  • ❌ Rate-limited endpoints: Those with strict usage limits
  • ❌ Resource-intensive queries: Complex requests that stress servers
  • ❌ User-specific endpoints: URLs requiring user authentication
  • ❌ Deprecated services: Services scheduled for retirement

Understanding the Monitor Table [​](/content/docs/1.0.0/desktop/monitor/#understanding-the-monitor-table "Direct link to Understanding the Monitor Table"/index.html)

The monitoring table displays real-time status information for all your monitored endpoints:

Table Columns [​](/content/docs/1.0.0/desktop/monitor/#table-columns "Direct link to Table Columns"/index.html)

URL [​](/content/docs/1.0.0/desktop/monitor/#url "Direct link to URL"/index.html)

  • Display: Shows the monitored endpoint URL
  • Truncation: Long URLs may be abbreviated
  • Tooltip: Hover to see the complete URL

Date [​](/content/docs/1.0.0/desktop/monitor/#date "Direct link to Date"/index.html)

  • Format: Shows the date of the last check
  • Updates: Refreshes after each monitoring cycle
  • Time zone: Displays in your local time zone

Status [​](/content/docs/1.0.0/desktop/monitor/#status "Direct link to Status"/index.html)

  • HTTP Codes: Displays the last received HTTP status code
  • Color Coding:
    • 🟢 Green (2xx): Service is healthy and responding
    • 🟡 Yellow (3xx): Redirects or warnings
    • 🔴 Red (4xx/5xx): Client or server errors

Actions [​](/content/docs/1.0.0/desktop/monitor/#actions "Direct link to Actions"/index.html)

  • Remove: Delete the endpoint from monitoring
  • More actions like test now and view detailed response are coming soon.

Interpreting Status Codes [​](/content/docs/1.0.0/desktop/monitor/#interpreting-status-codes "Direct link to Interpreting Status Codes"/index.html)

Success Codes (2xx):

  • 200 OK: Perfect response, service is healthy
  • 201 Created: Successful resource creation
  • 204 No Content: Successful request with no response body

Redirect Codes (3xx):

  • 301/302: Service moved, may need URL update
  • 304 Not Modified: Cached response, normal for some services

Client Error Codes (4xx):

  • 400 Bad Request: Malformed monitoring request
  • 401 Unauthorized: Authentication required
  • 403 Forbidden: Access denied
  • 404 Not Found: Service endpoint not available
  • 429 Too Many Requests: Rate limit exceeded

Server Error Codes (5xx):

  • 500 Internal Server Error: Service experiencing issues
  • 502 Bad Gateway: Proxy/gateway error
  • 503 Service Unavailable: Service temporarily down
  • 504 Gateway Timeout: Service response timeout