PrizmDoc® Viewer v14.0 Release - Updated
PrizmDoc Viewer / API Reference / PrizmDoc Server REST API / Self-Hosted Administration / Health Status
In This Topic
    Health Status
    In This Topic

    Introduction

    For customers who are self-hosting PrizmDoc Server, the health REST API allows an administrator or application to check the health of a PrizmDoc Server instance.

    Available URLs

    URL Description
    GET /PCCIS/V1/Service/Current/Health Determines whether or not a specific PrizmDoc Server instance is healthy.
    GET /PCCIS/V1/Service/Current/Info Gets metadata about the current status of a specific PrizmDoc Server instance.
    GET /admin Returns an HTML page that displays the status of a specific PrizmDoc Server instance.

    GET /PCCIS/V1/Service/Current/Health

    Determines whether or not a specific PrizmDoc Server instance is healthy.

    NOTE: For a Kubernetes cluster, see Checking PrizmDoc Viewer Kubernetes Cluster Health.

    Response

    You can use the HTTP status code to determine the health of the instance:

    HTTP Status Code Status
    200 Healthy
    500 Unhealthy

    You can also determine health by looking at the response body. When healthy, the response body will be plaintext with a value of OK. When unhealthy, the response will have no body.

    NOTE: If PrizmDoc Viewer has just started, unhealthy status may be returned for a short time until the system has completely started up.

    Example

    Request

    GET http://prizmdoc_server_base_url/PCCIS/V1/Service/Current/Health
    
    

    NOTE: See the Base URL for PrizmDoc Server topic for more information.

    Response

    HTTP/1.1 200 OK
    
    OK
    
    

    GET /PCCIS/V1/Service/Current/Info

    Gets metadata about the current status of a specific PrizmDoc Server instance.

    NOTE: Do not take any actions when any child service reports unhealthy status. PrizmDoc Server has its own mechanism to recover.

    NOTE: We recommend using the GET /PCCIS/V1/Service/Current/Health API when checking PrizmDoc Server health automatically.

    Successful Response

    Response Body

    JSON with the following:

    • serviceStatus (String) Status of PrizmDoc Server:
      • "starting"
      • "running"
      • "unhealthy"
    • licenseStatus (String) Information about the PrizmDoc Server License:
      • "retrieving" - Returned when the product is starting and the licensed status is not yet known.
      • "unlicensed" - Returned when the provided license key is not valid. Your license may be expired, or you may not have correctly configured your license key.
      • "licensed as 'Your Solution Name'" - Returned when a valid license key is found. Your Solution Name will be replaced with the value of your actual solution name.
    • instances[] (Array of Objects) Objects describing the PrizmDoc Server instances that are currently running. Items contain:
      • serviceStatus (String) Status of the PrizmDoc Server used for viewing.
      • serviceInstallerVersion (String) Version of the installer used to install PrizmDoc Server.
      • pccisVersion (String) Version of the PrizmDoc Server used for viewing.
      • runtimeVersion (String) .NET runtime version supporting the PrizmDoc Server used for viewing.
      • operatingSystem (String) Operating System of the server on which PrizmDoc Server is running.
      • startTime (String) Last recorded time the PrizmDoc Server were started. Time is reported in UTC and is ISO-8601 format.
      • instanceId (String) Host name of the server running PrizmDoc Server.
      • childServices[] (Array of Objects) Objects describing the health status for each individual PrizmDoc Service. > NOTE: It's important not to programmatically depend upon the value of a Service name because the total number of items in the childServices array may change from release to release (items may be added or removed). Items may contain:
        • name (String) Name of the child PrizmDoc Service.
        • status (String) Status of the child PrizmDoc Service:
          • "starting"
          • "running"
          • "unhealthy"

    Example

    Request

    GET http://prizmdoc_server_base_url/PCCIS/V1/Service/Current/Info
    
    

    NOTE: See the Base URL for PrizmDoc Server topic for more information.

    Response

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
      "serviceStatus": "running",
      "licenseStatus": "licensed as 'Acme Inc.'",
      "instances": [
        {
          "serviceStatus": "running",
          "serviceInstallerVersion": "XX.X.XX.XXX",
          "pccisVersion": "XX.X.XX.XXXX",
          "runtimeVersion": "4.0.30319.34014",
          "operatingSystem": "Microsoft Windows NT 6.3.9600.0",
          "startTime": "1971-01-01T00:00:00.0Z",
          "instanceId": "myhostname",
          "childServices": [
            {
              "name": "PCC Error Reporting Service",
              "serviceStatus": "running"
            },
            {
              "name": "PCC Imaging Conversion Service",
              "serviceStatus": "running",
              "version": "X.X.XXXX.XXXX"
            },
            {
              "name": "PCC PDF Processing Service",
              "serviceStatus": "running"
            },
            {
              "name": "PCC Raster Conversion Service",
              "serviceStatus": "running",
              "version": "X.X.XXXX.XXXX"
            },
            {
              "name": "PCC Vector Conversion Service",
              "serviceStatus": "running",
              "version": "X.X.XXXX.XXXX"
            },
            {
              "name": "PCC Html Conversion Service",
              "serviceStatus": "running",
              "version": "X.X.XXXX.XXXX"
            },
            {
              "name": "PCC Work File Service",
              "serviceStatus": "running",
              "version": "X.X.X"
            },
            {
              "name": "PCC Office Conversion Service",
              "serviceStatus": "running",
              "version": "X.XX.XXXX.XXXX"
            },
            {
              "name": "PCC Format Detection Service",
              "serviceStatus": "running"
            },
            {
              "name": "PCC AutoRedaction Service",
              "serviceStatus": "running"
            },
            {
              "name": "PCC Redaction Service",
              "serviceStatus": "running",
              "version": "X.X.X"
            },
            {
              "name": "PCC Email Processing Service",
              "serviceStatus": "running"
            },
            {
              "name": "PCC Email Conversion Service",
              "serviceStatus": "running",
              "version": "X.X.XXXX.XXXX"
            },
            {
              "name": "PCC Content Conversion Service",
              "serviceStatus": "running"
            },
            {
              "name": "configuration-service",
              "serviceStatus": "running"
            },
            {
              "name": "licensing-service",
              "serviceStatus": "running"
            },
            {
              "name": "health-service",
              "serviceStatus": "running"
            }
          ]
        }
      ]
    }
    
    

    GET /admin

    Returns an HTML page that displays the status of a specific PrizmDoc Server instance.

    It may take several minutes for PrizmDoc Server to become completely healthy. The page will auto-refresh as PrizmDoc Server comes online.

    NOTE: Use the GET /PCCIS/V1/Service/Current/Health API when checking PrizmDoc Server health automatically.

    Response

    Returns an HTML page that displays the status of a specific PrizmDoc Server instance.

    Example

    Request

    GET http://prizmdoc_server_base_url/admin
    
    

    NOTE: See the Base URL for PrizmDoc Server topic for more information.

    Response

    HTTP/1.1 200 OK
    
    <!DOCTYPE html>
    ...