How to fetch Bamboo Data Center Idle agent reports unused for build plans and deployments using database queries
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
The steps outlined on this article are provided AS-IS. This means we've had reports of them working for some customers — under certain circumstances — yet are not officially supported, nor can we guarantee they'll work for your specific scenario.
You may follow through and validate them on your own non-prod environments prior to production or fall back to supported alternatives if they don't work out.
We also invite you to reach out to our Community for matters that fall beyond Atlassian's scope of support!
This article explains how to generate a list of Idle Bamboo agent reports that have been unused since a specific date for build plans and deployments from the database.
Building SQL statements for reporting purposes is not part of the Atlassian Support scope and this work is provided "as-is", on a best-effort basis. Queries may work better or worse than expected, your mileage may vary. It is up to each customer to analyze each query individually and understand if that is enough for their specific needs.
Environment
The SQL queries listed on this page have been tested on Bamboo 9.2.7 with Postgres DB but may also work with other versions of Bamboo.
Solution
Always back up your data before making any database modifications. If possible, test any alter, insert, update, or delete SQL commands on a staging server first.
The SQL queries listed in this article cover the following reports:
Idle Agent unused report for builds plans
To list out remote agents who have not built any plan jobs since a specific date(say, 2024-08-12 00:00:00) use the DB query below:
1
2
3
4
5
6
SELECT DISTINCT Q.TITLE
FROM queue q LEFT JOIN buildresultsummary bs ON q.queue_id=bs.build_agent_id
where q.agent_type = 'REMOTE' AND (enabled=true or enabled=false) and (last_stop_time is null) AND Q.TITLE not in
(SELECT DISTINCT Q.TITLE
FROM queue q LEFT JOIN buildresultsummary bs ON q.queue_id=bs.build_agent_id
WHERE bs.build_completed_date > '2024-08-12 00:00:00')Idle Agent unused report for deployment projects
To list out remote agents who have not built any deployment jobs since a specific date(say, 2024-08-12 00:00:00) use the DB query below:
1
2
3
4
5
6
SELECT DISTINCT Q.TITLE
FROM QUEUE Q LEFT JOIN DEPLOYMENT_RESULT DR ON Q.QUEUE_ID = DR.AGENT_ID
where q.agent_type = 'REMOTE' AND (enabled=true or enabled=false) and (last_stop_time is null) AND Q.TITLE not in
(SELECT DISTINCT Q.TITLE
FROM QUEUE Q LEFT JOIN DEPLOYMENT_RESULT DR ON Q.QUEUE_ID = DR.AGENT_ID
WHERE DR.FINISHED_DATE > '2024-08-12 00:00:00')Was this helpful?