What Bamboo URL should I use for HTTP healthchecks?
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Administrators may wish to monitor if Bamboo Server is up and running at any given time. This can also be used as a health check status endpoint for load balancers or proxies. This article suggests a simple approach to address this requirement.
Solution
Bamboo Server 7.0 or later provides two endpoints that can be used to report the status of the server. These are /rest/api/latest/status and /rest/api/latest/server. To effectively return the server status the REST API plugin needs to be enabled and working.
For example, the following command:
1
$ curl <Bamboo_Base_URL>/rest/api/latest/statusWill return one of the following responses, depending on the current status of your Bamboo Server:
Response | HTTP response code | Meaning |
|---|---|---|
| Other | Tomcat/Bamboo Server is too busy to respond to this request. |
| Other | Tomcat/Bamboo Server is not running or has not yet started listening for requests. |
curl hangs waiting for response | Other | Tomcat/Bamboo Server has started and listening but not responding. |
| 200 | Bamboo is up and running Ready to receive in-coming requests. |
| 200 | Bamboo has been paused from the UI or rest API. |
The /rest/api/latest/server endpoint can also be used to return the server status. Prior to Bamboo 7.0 this was the only endpoint. The response provides a little more detail and also indicates whether a reindex is currently running. e.g.
1
2
$ curl <Bamboo_Base_URL>/rest/api/latest/server
> <?xml version="1.0" encoding="UTF-8" standalone="yes"?><restServerStatusInfo><state>RUNNING</state><reindexInProgress>false</reindexInProgress></restServerStatusInfo>See also https://docs.atlassian.com/atlassian-bamboo/REST/7.2.1/
Was this helpful?