Health Checks

The Health Checks feature enables automated testing by calling API resources.

Through a health check, users can verify request and response contents to check whether a given HTTP resource is working well.

If the user has already registered health checks before, the screen will show all registered health checks, as shown below:

The screens shown below may vary depending on the version of the Sensedia API Platform.
health checks list en

Please note that there are some mechanisms and buttons to consider on the listing screen:

  • EXECUTE: it runs all health checks on the list. A request will be made to each of the items on the list by executing the HTTP method, using the URL and the request headers and body informed.

  • IMPORT: it imports previously registered health checks. To perform the importing action, you must upload a JSON file.

  • EXPORT: it creates a backup file, in JSON format, for later use.

Creating, editing and deleting health checks

To register new health checks, click the + button to open the registration modal window:

health checks create

These are the fields to be filled in:

  • Method: required field to be filled in with the HTTP method that will be called in the execution of the health check. It may be GET, POST, PUT, or DELETE.

  • URL: required field to be filled in with the URL of the HTTP or API resource that will be used to verify the health check.

  • Expected HTTP Return Code: it represents the expected HTTP code after the request is executed. If this field is empty, any status value between 200-399 will be considered valid.

  • Request Headers: insert the header values ​​that will be used during the request to the URL informed, if necessary. Include one header per line.

  • Request Body: if the method to be executed is POST or PUT, this field can be filled with the contents of the request body that will be used in the health check call.

  • Expected Body: enter the content that will be used to compare the request result and the expected result after the health check has been executed.

    API Manager versions prior to the release 4.3.5.0 contain one more field: Automatic (every 15 minutes), whose feature was discontinued after the release 1901.1.0.0. Originally, the field prompted the health check at hand to be executed automatically every 15 minutes.

    Sensedia has a solution focused on automatic monitoring and alerts regarding API performance: Flexible Actions.

After completing all necessary fields, the user can confirm the registration by clicking the SAVE button. The new health check will be displayed on the listing screen. To cancel the operation, click the Cancel button.

To edit a record, click the icon edit button to open the health check registration screen containing the information for editing.

To delete a health check, click the icon delete button. A confirmation prompt will be displayed. After confirmation, the record will be deleted.

Viewing health check results

To view the results of a specific health check, click any of the URLs on the list. You will be redirected to the results display screen, as shown below:

health checks view

This screen shows an example of a result that is displayed after the selected health check ran. When the result of the execution matches what had been configured previously, the frame has a green background.

This frame displays the information of the request made, such as the request and response headers of the call, as well as the request and response content.

health checks success

If the health check has an invalid result, the frame will have a red background but display the same information described previously, as in the following figure:

health checks fail

For health checks with more than 12 records, use the Load more button to view the remaining items.

health checks load more

These features make the Health Checks view a more effective way to monitor HTTP resources.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]