Maesh includes a built-in API that can be used for debugging purposes.
This can be useful when Maesh is not working as intended.
The API is accessed via the controller pod, and for security reasons is not exposed via service.
The API can be accessed by making a
GET request to
http://<control pod IP>:9000 combined with one of the following paths:
This endpoint provides raw json of the current configuration built by the controller.
This may change each request, as it is a live data structure.
This endpoint provides a json array containing some details about the readiness of the Maesh nodes visible by the controller This endpoint will still return a 200 if there are no visible nodes.
This endpoint provides raw json of the current configuration on the Maesh node with the pod name given in
This endpoint provides a 404 response if the pod cannot be found, or other non-200 status codes on other errors.
If errors are encountered, the error will be returned in the body, and logged on the controller.
This endpoint returns a 200 response if the controller successfully deployed a configuration to all Maesh nodes, and Maesh is ready for use. Otherwise, it will return a 500.
This endpoint provides a json array containing details about configuration deployments made by the controller. This array is currently capped at 1000 entries to avoid memory issues. If this is not enough, please open a github issue and we will look into updating this to be configurable.