EUM Server Endpoints

The EUM Server has different endpoints serving distinct functions. This page provides a reference for testing the health and getting information about on-prem EUM Servers.

The endpoints include the following:

  • EUM API- acts as the interface between the EUM Server and the Controller. The Controller retrieves EUM data from the EUM Server through the EUM API endpoint.
  • EUM Collector- collects metrics from the EUM agents. The JavaScript Agent and Mobile Agents transmit data to the EUM Server through the EUM Collector endpoint.
  • EUM Aggregator- collects and rolls up all the metrics per application and provide an interface for Controllers to download the metrics by application and timestamp.
  • Screenshot Service- collects and serves image tiles that form mobile screenshots. The Mobile Agents transmit the tiles to the Screenshot Service, and the Controller retrieves the tiles to display the screenshots in mobile sessions.

EUM Server Endpoint URLs

The table below lists the endpoints, the default URL, and the supported paths.

EUM Server Endpoint Default URL Paths / Description
EUM Collector http(s)://<domain-name>:7001/eumcollector
/adrum.gif Receives image beacons from the JavaScript Agent.
/beacons/browser Earliest endpoint for receiving CORS beacons from the JavaScript Agent.
/beacons/browser/v1/* The V1 endpoint for receiving CORS beacons from the JavaScript Agent.
/beacons/browser/v2/* The V2 and latest endpoint for receiving CORS beacons from the JavaScript Agent.
/get-version Returns the version, build, and commit, and timestamp of the EUM Processor.
/iot/v1/application/* The endpoint for IoT REST APIs. See the IoT REST API reference documentation for details.
/ping Returns whether the EUM Collector is accessible and running.
/mobileMetrics?version=2 The endpoint used by the Mobile Agents to send mobile beacons via HTTP POST.
/whoami Returns the IP address, geo location, and information of the client making the request.
EUM Aggregator http(s)://<domain-name>:7001/eumaggregator
/currentTime Returns the current time of the EUM Aggregator as a Unix timestamp.
/get-version Returns the version, build, and commit, and timestamp of the EUM Processor.
/ping Returns whether the EUM Aggregator is accessible and running.
Screenshot Service http(s)://<domain-name>:7001/screenshots/v1
/version Returns the version, build, commit, and timestamp of the Screenshot Service.