Uploaded image for project: 'Hadoop HDFS'
  1. Hadoop HDFS
  2. HDFS-12027

Add KMS API to get service version and health check

    XMLWordPrintableJSON

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: kms
    • Labels:
      None

      Description

      Enhancement request, add a non-privileged user API to the Key Management Server which would return the product's build version. This API would allow users the ability to quickly verify the service is up as well as to retrieve the KMS instance build version.

      Suggested API:

      GET http://HOST:PORT/kms/v1/key/kms_build_version

      Return:

      200 OK
      Content-Type: application/json
      {
      "BuildVersion" : "<Dotted_Version>" // example "BuildVersion" : "1.2.3.4"
      }

      Applications for this API are health monitoring dashboards, and cluster installation reporting by Production, Service and Release engineering teams. The API would also be useful for users, clients and non-admins to do adhoc verification that a specific KMS instance is available or to check its version.

      Such an API would also be useful for debugging initial bring-up of a service instance, such as validation of the KMS webserver and its interaction with ZK before the key manager(s) are necessarily working.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                patwhitey2007 patrick white
              • Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated: