DX APM Infrastructure Agent downloaded from SaaS as APMIA Agent in the latest version 184.108.40.206. This Infrastructure Agent is installed on a Server running already the CA Service Management Server SDM 17.3 installed before. The Tomcat Shutdown Port in SDM is 8085. When the CA Infrastructure Agent Service is started the SDM Tomcat shuts down.
This problem is related to the defect DE531944 & CGR US813039. The default configuration of the Infrastructure Agent has the http-collector configured by default and this is using Port 8085 overlapping with the default Tomcat Shutdown Port of CA SDM 17.3.
CA SDM Tomcat | Tomcat Shutdown Port: 8085
HTTP Collector Ingress Resource Creation backend: serviceName: apmia-http-collector-web servicePort: 8085
Windows Server 2019
CA Service Management Server SDM 17.3- already installed before
DX APM Infrastructure Agent 220.127.116.11 - being installed as a 2nd instance of the APMIA on the same machine
To be fixed in a future release of DX APM SaaS AMPIA Agent.
Change the Tomcat shutdown port number from 8085 to a non-used port. Below is the SDM doc link on port configuration:
Deactivate the http-collector in the extensions/Extensions.profile file by commenting in the line below as you can see on the screenshot.
IMPORTANT NOTE: The http collector extension can be disabled only if no NodeJS monitoring is required.
Alternatively, you can change the default port "8085" of the http-collector extension via ACC(APM Command Center). ACC (APM Command Center) option will be available in the DX-APM SaaS
APM Command Center: To change the http-collector extension default port.
DX-APM -> Settings (Left pane) -> APM Command Center
For more information on ACC, please refer to the tech doc:
In case the nodejs monitoring is needed, you can alternatively change only the http-collector port in the bundles.properties file. Http-collector port 8085 can be set to any free port on the server and there are no restrictions to that. It's just a listening port so the only requirement is to configure whatever probe is sending the data in to get to the correct port.
You can use the following command to install and uninstall your APMIA instance:
APMIACtrl.bat install service_name "<service_name>" display_name "<display_name>" APMIACtrl.bat uninstall service_name "<service_name>" display_name "<display_name>"
Question #1 What is http-collector?
Answer: The http-collector is a collector agent where probes like nodejs can communicate with the protocol HTTP/HTTP(s). It is part of APMIA. The probes were connected using ARF protocol and there is still backward compatibility which means probes can still connect to APMIA using ARF. The HTTP protocol supports the scale of collector-agents/APMIA and it can have an external load balancer where 100/1000 probes can connect to APMIA without having knowledge of APMIA where it connects.
Background: ARF protocol has a limitation of accepting 15 probes per APMIA and it cannot work with std load balancers hence configuration at probes becomes quite difficult in pointing 15 sets of probes to one APMIA. The HTTP protocol can address these limitations.
Question #2: Can this interface be used to receive data as far as there is already a REST interface in EPAgent / APMIA that is used to receive metrics and transaction trace data?
Answer: EPAgent still exists. Yes, REST APIs are available with Http-Collector and they are more compatible with the probe's ARF(Agent Remote Function) messages. It also needs tracers at APMIA like extensions NodeExtension, PHPExtension, etc... for Function Call and Returns messages. It can have another agent (Hostname|Process|Agent) for each probe (whereas EPAgent reports metrics in the same APMIA).
Question #3 Which probes does the new collector already support and/or is intended to support in the future?
Answer: Presently, only supported for Nodejs and yes, there was a feature plan to migrate for other probes (Python, PHP, etc...) from ARF to HTTP. However, for the moment we do not have any timeline fixed for any other probes than Nodejs.