Installing Endpoint Agent Pulse for Mac OS X

Last updated: Thu Jun 20 22:37:41 GMT 2019

Endpoint Agent collects data about web browsing performance and network connectivity.  Similar to the Endpoint Agent, Endpoint Agent Pulse collects data on web browsing performance and network connectivity. However, Endpoint Agent Pulse does not obtain browser session data. This provides organizations a way to measure and troubleshoot their customer's digital experience.

Organizations who do not require browser session data can now share a public download link for Endpoint Agent Pulse. Endpoint Agent Pulse supports two operating systems: macOS (Mavericks and later) and Windows (7 or later).

Endpoint Agent Pulse offers some of the same functionality as the normal Endpoint Agent. As noted, browser session data is not recorded with Endpoint Agent Pulse.

How to Install Endpoint Agent Pulse

Select the option for Endpoint Agent Pulse and choose the download option.

    1. Navigate to  Endpoint Agents > Agent Settings > Add New Endpoint Agent Button.  

       
    2. Select the Endpoint Agent Pulse Option

 

  1. To provide this link to allow anyone to download the Endpoint Agent Pulse Select the toggle control to reveal the links

Installing the Endpoint Agent Pulse for Mac OS X

The ThousandEyes Endpoint Agent is a browser extension application installed on a user's computer to collect web performance data for websites within configured domains and networks.This document outlines downloading the Endpoint Agent installer file, and installing and enabling the Endpoint Agent for a Mac OS X user.

Endpoint Agent requires Mac OS X 10.9 (Mavericks) or later, and Google Chrome installed on your computer. Complete operating system and browser support for Endpoint Agent is documented here.

Distribution of Installers

Endpoint Agent Pulse is custom-built for each account. Access to the Endpoint Agent installer from our site requires a ThousandEyes username and password. Customers will need to download the installer file, and distribute internally to users without a ThousandEyes account that has access to the installer file.

Downloading the Endpoint Agent Pulse installer

  1. Navigate to  Endpoint Agents > Agents 
  2. Click Add New Endpoint Agent Pulse Button
  3. Download the appropriate Installer file based on your operating system architecture. Click Download - Mac PKG or Mac PKG to start downloading the MSI installer file.  Depending on your security settings, you may see a warning that the file can harm your computer, per the image below.  Select the Keep option to continue the download.
  4. Click the Keep button to continue the download.
  5. Once downloaded, double click the file in the receiving folder to start the installation.

Installing the Endpoint Agent Pulse

  1. Launch the installer.  You'll be prompted by the wizard through the installation steps.  Click the Continue button.

  2. Read the End-user License Agreement and Terms of Use.  Click the Continue button.

     
     
  3. Accept the End-user License Agreement and Terms of Use.  Click the Agree button to continue.


     
  4. Accept the default location for the software installation by choosing the Install for all users of this computer option. Click the Continue button


     
  5. Next, you'll be shown how much disk space the ThousandEyes Endpoint Agent Pulse will consume.  Click the Install button.


     
  6. Your system will prompt for the username and password of an account with rights to install software.  Enter your username and password, then click the Install Software button.

        
     
  7. After installation completes (it should take less than a minute to install), you'll see an installation summary.  Click the Close button to Launch Google Chrome to complete the installation.
  8. Google Chrome will launch and prompt you to add the extension for Chrome.  Click the Add to Chrome button to add the extension.
    1. Clicking on Add to Chrome, makes a request to Google Web Store. If access to Google Web Store is blocked, please allow the following URL to be available -  https://chrome.google.com/webstore/detail/thousandeyes-endpoint-age/ddnennmeinlkhkmajmmfaojcnpddnpgb
  9. After you click the Add to Chrome button, Chrome will prompt you to accept the changes required by the Endpoint Agent.  Click the Add extension button to continue.
  10. Once added, the extension will show a notification next to the newly-added toolbar button in Chrome.

Collecting data using the Endpoint Agent Pulse

The Endpoint Agent installer Pulse is custom-built for each ThousandEyes account, and contains a built-in account key.  This account key is used to route the collected performance data into the right ThousandEyes account.

Two modes of data collection exist:

  1. Automatic data collection: With the Endpoint Agent Pulse installed, if a user browses to a webpage whose domain is configured in a "Monitoring Profile"  and the public IP address of the client machine is detected to be inside a "Monitored Network" for that domain, the Endpoint Agent Pulse will gather web browsing performance and network layer connectivity data associated with the user's browsing session.
  2. Manual data collection: A user can initiate data collection by clicking the ThousandEyes Endpoint Agent Pulse extension button from the browser toolbar. While the Endpoint Agent Pulse is recording your browsing session, the top of the page will show a banner indicating that ThousandEyes Endpoint Agent Pulse is debugging this tab. To stop recording, simply click the same ThousandEyes extension button in the browser toolbar, or click the Cancel button on the banner.

 

Uninstalling ThousandEyes Endpoint Agent Pulse

The procedure to uninstall  the ThousandEyes Endpoint Agent Pulse on Mac OS X is illustrated in this article.