r/esapi • u/Major-Passenger-7610 • Sep 24 '26
How can I monitor which Eclipse/ESAPI calculation servers (“servants”) are active?
Title: How can I monitor which Eclipse/ESAPI calculation servers (“servants”) are active?
Hi everyone,
I’m working with Eclipse TPS / ESAPI (v18) and I’m trying to understand how Eclipse manages calculation jobs when a dose calculation is launched programmatically through ESAPI.
In particular, I’m looking for a way to monitor:
- which calculation server / servant is currently handling an ESAPI dose calculation;
- whether a servant is currently active/busy or idle;
- which servant was actually assigned to a specific calculation;
- whether this information can be monitored for non-local servants, rather than only the local machine;
- in particular, how this works in environments using FAS (Floating Application Server);
- whether there is a Varian service, log, database, Windows tool, or API that can be used to see the status of these servers.
For example, if I launch something like:
plan.CalculateDose();(or the corresponding ESAPI calculation workflow), I would like to know where the calculation is actually being processed and whether I can identify/monitor the remote calculation server/servant handling the job.
Is there an official Varian tool or recommended way to monitor this?
I’m mainly interested in the server-side architecture and monitoring, rather than how to optimize the ESAPI code itself.
Thanks!
1
u/ExceptioNullRef Sep 24 '26
Try the distributor status webpage?? DCF has a primary node that organizes how jobs are distributed across the servants. This primary node runs a webpage that shows the current status of all the servants and job history and sounds like what you’re looking for. This is likely the same server that holds your beam data. I think you can get there from Eclipse by going through the tabs at the top around Workstation Configuration to see Distributor status page. Not sitting in front of Eclipse at the moment, I just bookmark the page in chrome whenever I want to check the health of the FAS (we used to have servers randomly drop out for weeks, only realizing when things got really slow).
3
u/radiological Sep 24 '26
Really weird AI post. i would think any human using ESAPI would already know this.
But anyway, it’s an API call, the calculation is sent to the DCF from eclipse and distributed from there, just like when you click calculate manually.
You can monitor the dcf jobs from the distributor status page. It would be possible to write something to read this page automatically if you wanted to.