Skip to main content
Version: 1.1.0

Reporting

The Report section in Quetzly Validator lets you run a full health check across an entire ArcGIS Server instance in one click. Quetzly discovers every service in every folder, runs assertion checks on each one, and presents the results in a sortable table with summary charts — all exportable as a PDF.

Accessing the Report Interface​

  1. Click the Report icon in the left sidebar
  2. The Report panel displays:
    • Server URL input: Enter your ArcGIS Server root URL
    • Run button: Start the health check
    • Export PDF button: Download the report as a PDF (visible after a run)
    • Results dashboard: Summary cards, charts, and the service table

Running a Report​

  1. Enter your ArcGIS Server root URL in the input field:
    https://yourserver.com/arcgis/rest/services
  2. Click "Run"
  3. Quetzly will:
    • Discover all services across all folders
    • Run assertion checks on each service concurrently
    • Display a progress message as it works
  4. Results appear automatically when the scan is complete

Understanding the Results​

Summary Cards​

At the top of the report, four cards give you an at-a-glance overview:

CardDescription
Total ServicesTotal number of services discovered, with a type breakdown
Health ScorePercentage of services with all checks passing
Critical OutagesNumber of services with critical failures
Avg ResponseAverage response time across all services (ms)

Charts​

Two charts provide a visual summary:

  • Health Donut Chart: Shows the proportion of Healthy / Warning / Critical / Unsupported services
  • Service Type Bar Chart: Shows the count of each service type (MapServer, FeatureServer, ImageServer, etc.)

Service Table​

The table lists every discovered service with the following columns:

ColumnDescription
ServiceService name and folder path. Click the name to open the service in the API section.
TypeService type (MapServer, FeatureServer, ImageServer, GPServer, etc.)
Status🟢 Healthy · ⚠️ Warning · 🔴 Critical · ⬜ Unsupported
IssuesList of failed assertion checks
ResponseResponse time in milliseconds

Click any column header to sort the table by that column.

Filtering Results​

Use the filter buttons above the table to narrow down the view:

  • All — Show every service
  • Healthy — Only services that passed all checks
  • Warning — Services with non-critical failures
  • Critical — Services with critical failures

Assertion Checks by Service Type​

MapServer​

CheckWhat it verifies
Service reachableHTTP 200 returned
Has layersAt least one layer defined
Spatial referenceWKID is consistent with extent coordinates
Export mapA map export request returns a valid image

FeatureServer​

CheckWhat it verifies
Service reachableHTTP 200 returned
Spatial reference definedService has a spatial reference
Spatial reference consistentWKID matches the extent coordinate scale
Has layers/tablesAt least one layer or table defined
Feature countsEach layer contains at least one feature

ImageServer​

CheckWhat it verifies
Service reachableHTTP 200 returned
Valid extentExtent is not 0,0,0,0
Pixel sizePixel size is non-zero
Band countBand count is non-zero
Spatial referenceSpatial reference is defined

GPServer​

Quetzly confirms the service is reachable (HTTP 200). Detailed GP task checks are not currently implemented.

Other Service Types​

Services that are not MapServer, FeatureServer, ImageServer, or GPServer are marked as Unsupported (⬜) and skipped.

Status Icons​

IconMeaning
🟢All assertion checks passed
⚠️Some checks failed, but no critical issues
🔴Critical failure — service unreachable, no layers, bad status, etc.
⬜Service type is not currently supported for assertion checks

Opening a Service in the API Section​

Click any service name link in the table to jump directly to the API section with the service URL and type pre-filled, ready to inspect further.

Exporting a PDF Report​

After a run completes, click Export PDF to download the full report as a PDF:

  • Includes the Quetzly logo and server URL header
  • Captures the charts and the full service table
  • Automatically named quetzly-dashboard-YYYY-MM-DD.pdf
  • Formatted as A3 landscape for readability

Tips​

  • Large servers: For servers with many services and folders, the scan may take a minute or two. A progress message keeps you informed.
  • Rate limiting: Running reports frequently against the same server may trigger rate limits on the server side.
  • Unsupported types: Services shown as ⬜ Unsupported are discovered and listed, but no assertion checks are run on them.