# Monitoring Webex Meetings with Cloud and Enterprise Agents

## Best Practices

We recommend that you set up the following tests with Webex Cloud Agents to better understand your Webex Meeting performance. For full visibility into Webex, these tests should supplement any HTTP server, web transaction, or DNS tests that you have targeting your Webex environment. For instructions on setting up the recommended tests, a Webex Meeting Health dashboard, and custom alerts, see the [Webex Meeting Test Template](#webex-meeting-test-template) section below.

* **An RTP Stream Test** between any applicable Enterprise Agents and the Webex Cloud Agent hosted within the VPC of your closest multimedia platform server. You should use (UDP) 9000 and 5004, with DSCP 46. This will help you understand inbound performance of voice traffic into the Webex Cloud environment.

  ![Figure 1: RTP stream test targeting port 5004 with DCSP 46](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-c63379afe69d5cf8bc27dd8932763d91bb18c85d%2Frtp-stream-5004-dscp46.png?alt=media\&token=187bfe06-3eaa-4bf2-9c0e-b21ed894506b)
* **An Agent-to-Agent Bidirectional Test** between any applicable Enterprise Agents and the Webex Cloud Agent hosted within the VPC of your closest multimedia platform server. You should use (UDP) 9000 and 5004, with DSCP 34. This will help you understand simulated, bidirectional performance of video-marked traffic into the Webex Cloud environment.

  ![Figure 2: Network agent-to-agent UDP test targeting port 5004 with DCSP 34](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-499c46d882e13f0b364547517a2474ba990272a7%2Fnetwork-a2a-udp-5004-dscp34.png?alt=media\&token=5467cf78-db92-4dbd-b1e6-8f625af76a5f)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Keep in mind that for agent-to-agent tests, in many cases you must configure the firewall to allow the test to succeed. For detailed information, see <a href="https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/configuring/firewall-configuration-for-enterprise-agents">Firewall Configuration</a>.</p></div>

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If the Enterprise Agent in the test is behind a NAT, you must also select the <strong>Behind a NAT</strong> option. For detailed information, see <a href="https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/configuring/nat-traversal-for-agent-to-agent-tests#nat-traversal-requirements">NAT Traversal Requirements</a>.</p></div>
* **Optional: Secondary RTP Stream and Agent-to-Agent Bidirectional Tests** For more complete visibility, set up the above RTP stream and agent-to-agent tests to your second-closest multimedia platform server. You should use the same test settings targeting your backup Webex multimedia platform location, providing visibility into its reachability and network traffic performance.

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If you attempt to run a TCP-based test, we recommend that you enable <a href="https://docs.thousandeyes.com/archived-release-notes/2020/2020-07-release-notes#in-session-path-trace-mode-for-network-agent-to-agent-tests">in-session path trace mode</a> for consistent path visualization results. If you don’t enable this setting, you may notice TCP packets getting dropped at the ingress of the Webex infrastructure.</p></div>
* **Vanity Webex HTTP Server URL Test** for monitoring the primary landing page that your users connect to when they access Webex. This example shows `https://cisco.webex.com`, but you will want to use `https://<your-company-name>.webex.com`.

  ![Figure 3: Vanity Webex HTTP server test](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5f53eb0aa3e7dc27e67e270d2eab03faaedb55d6%2Fvanity-webex-http-server-test.png?alt=media\&token=adea3b05-f45d-464c-9087-7d74b2c4a921)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Make sure to update the <strong>Advanced Settings > Network > Data Collection > Protocol</strong> to <strong>ICMP</strong>.</p></div>
* **Authoritative Webex DNS Server Test** is used to ensure that your vanity Webex domain is properly resolving both internally and externally. When using Enterprise Agents, update the **DNS Servers** field to use your internal name servers. If you use Cloud Agents for external visibility, use the **Lookup Servers** button to auto-populate the authoritative external name servers. This example shows Cloud Agents resolving cisco.webex.com. You will need to update it to your organization's vanity domain.

  ![Figure 4: Authoritative Webex DNS server test](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-81c7b0c05e04bf671f6c84b00d8d48ac25166893%2Fauthoritative-webex-dns-server-test.png?alt=media\&token=96a274e3-aeea-48b9-acae-3a8b68989dd5)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If you use and Enterprise Agents, make sure to update the <strong>Advanced Settings > Network > Protocol</strong> to <strong>TCP</strong> and the <strong>Advanced Settings > Network > DNS</strong> to <strong>Send recursive queries</strong>. If you use both Cloud and Enterprise agents, set <strong>Advanced Settings > Network > DNS > Transport</strong> to <strong>UDP</strong>.</p></div>
* **Optional: Transaction Test to Check the Webex Status Page** The code sample below can be pasted into the **Transaction Script** field and used to monitor the [Webex Status page](https://status.webex.com/service/status?lang=en_US)

  ![Figure 5: Webex status page transaction test](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-da0cdaae491355c833c372ee2a33c2c4c2541e89%2Fwebex-status-page-transaction-test.png?alt=media\&token=3ef97d86-e88f-45ba-a7cc-e4e30fcfc08d)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Make sure to update <strong>Advanced Settings > Network > Data Collection > Protocol</strong> to <strong>ICMP</strong>.</p></div>

```javascript
import { By, Key } from 'selenium-webdriver';
import { driver, browser, markers } from 'thousandeyes';
runScript();
async function runScript() {
  await configureDriver();
  // Navigate to Webex Global Status Page
  await driver.get('https://status.webex.com/service/status?lang=en_US');
  await driver.takeScreenshot();
  // Find the card for Webex Meetings
  let webex_meetings = await driver.findElement(By.xpath(`//*[text()="Webex Meetings"]`));

  // click on webex meetings to show operational status
  await webex_meetings.click();

  // Scroll the card into view and take a screenshot
  await driver.executeScript("arguments[0].scrollIntoView({block: 'center'});", webex_meetings);
  await driver.takeScreenshot();

  // Find all the list items showing each component's status
  let items = await webex_meetings.findElements(By.xpath('./../..//li'));
  // Iterate over each list item...
  await Promise.all(items.map(async function (item) {
    let component = await item.findElement(By.css('span.text-secondary')).getText();
    let status = await item.findElement(By.css('span.font-body-small')).getText();
    console.log((await component), (await status));
    // ...and throw an error if any Webex Meeting Comopnent is non-Operational
    if (status != 'Operational') {
      throw Error('Component "' + component + '" is not operational: ' + status);
    }
  }));
}
async function configureDriver() {
  await driver.manage().window().setRect({
    width: 1440,
    height: 900 });
  await driver.manage().setTimeouts({
    implicit: 7 * 1000 // If an element is not found, reattempt for this many milliseconds
  });
async function configureDriver() {
    await driver.manage().setTimeouts({
        implicit: 7 * 1000, // If an element is not found, reattempt for this many milliseconds
    });
}

async function click(selector) {
    await simulateHumanDelay();

    const configuredTimeouts = await driver.manage().getTimeouts();
    const clickAttemptEndTime = Date.now() + configuredTimeouts.implicit;

    await reattemptUntil(attemptToClick, clickAttemptEndTime);

    async function attemptToClick() {
        await driver.findElement(selector)
                    .click();
    }
}

async function reattemptUntil(attemptActionFn, attemptEndTime) {
    const TIME_BETWEEN_ATTEMPTS = 100;
    let numberOfAttempts = 0;
    let attemptError;
    while (Date.now() < attemptEndTime || numberOfAttempts === 0) {
        try {
            numberOfAttempts += 1;
            await attemptActionFn();
        }
        catch (error) {
            attemptError = error;
            await driver.sleep(TIME_BETWEEN_ATTEMPTS);
            continue; // Attempt failed, reattempt
        }
        attemptError = null;
        break; // Attempt succeeded, stop attempting
    }

    const wasAttemptSuccessful = !attemptError;
    if (!wasAttemptSuccessful) {
        throw attemptError;
    }
}

async function simulateHumanDelay() {
    await driver.sleep(550);
}

async function typeText(value, selector) {
    await simulateHumanDelay();
    const element = await driver.findElement(selector);
    await element.clear();
    await element.sendKeys(value);
}

}
```

## Webex Meeting Test Template

The Webex meeting test template creates the set of tests recommended in the best practices section above. These tests are then automatically associated with a Webex Health dashboard, and custom alerts are created based on Webex monitoring best practices.

You can run the template multiple times, based on your monitoring requirements:

1. Navigate to **Cloud & Enterprise Agents > Test Settings**.
2. Use the pull down arrow beside **Add New Test**, and click **Add From Template**.
3. Scroll down and select the **Webex Meeting** template.

The following screenshot is an example of the Webex Meeting Deploy Template:

![Figure 6: Webex Meeting Deploy Template](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5b64f3d3cfc5c37cef936882d8a72c82d59fc8e4%2Fwebex-meeting-deploy-template.png?alt=media\&token=0fc668f1-81c7-4ca4-9b14-ef58d7dd6e87)

**Custom Template Fields**

{% hint style="info" %}
Use the "?" above the fields for helpful hints.
{% endhint %}

* Use the pull down to select the interval that will be used for all tests in the template. After the template deploys, you can update or modify individual tests. For example, you may want to run the DNS test at a 5 or 15 minute interval, instead of a 1 minute interval.
* Webex Site ID Name: This is your corporate site ID. For example, for cisco.webex.com only the site ID of `cisco` is required.
* Webex Port: This will default to port 5004 and can be updated to port 9000. If you want to monitor both ports, run the template the first time with port 5004 and then use the same selections and update the port to 9000. The **DNS Server** and **HTTP Server** tests will not be re-created the second time you run the template.
* Webex DNS Servers: Click the **Look Up Servers** button and the public DNS servers will automatically be populated. If you are running this test internally, we recommend you use your internal name servers, which can be added manually in the **Enter server** field. It is best practice to use the name server's IP address in this case.
* Target Webex Agent: Use the **Built-in tags** and select **Webex Cloud** to filter the associated [Webex Cloud Agents](#webex-cloud-agent-locations). Then select the agent in the Webex data center that you want your tests to target.
* Target Region (optional): This field can be used if you want tests to be configured for a certain region or building for easier troubleshooting, or based on your users. For example, you might use WEST and then target the Webex San Jose, CA Webex Data Center.
* Source Agents: These will be where the tests will be run from. If you have any custom [agent labels](https://docs.thousandeyes.com/product-documentation/getting-started/getting-started-with-cloud-and-enterprise-agents#adding-agent-labels) set up, you can use them to quickly filter and select agents.
* Name your template: The default is Webex and it can be updated to match your monitoring requirements.
* Click **Review** to verify what will be deployed.

The following image is an example of the **Ready to deploy?** page.

![Figure 7: Webex Meeting Readsy to Deploy](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-82a2fd1e91ef03ca09cabfb2eb2d6c7ddc5d56d4%2Fwebex-meeting-ready-to-deploy.png?alt=media\&token=f6e4cfb7-1e1d-4cd6-88e4-ca8252209b39)

Click the **Deploy Now** button to generate your template. It will then display the **Setup Completed Successfully!** page, shown in the screenshot below.

![Figure 8: Setup Completed Successfully!](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0095f12251f020299d817edf12dbe9b8bbc9fb16%2Fwebex-meeting-template-deployed.png?alt=media\&token=e66a24d4-9a10-47b4-8d35-34b45310c1b2)

{% hint style="warning" %}
If there are any issues, they will display at the bottom with information on how to correct the problem/s. You can always reach out to ThousandEyes Support if the issue persists.
{% endhint %}

Once the setup is completed, you can:

* Click **Done** button to go back to the **Tests** page.
* Click **Create Another Template** if you want to deploy more templates.
* Click **Go to Test Settings** for a filter view of the tests created by the template.
* Click **Go to Dashboards** to open the Webex Health Dashboard.

{% hint style="info" %}
**Testing Multiple Webex Agents**

You can create additional tests targeting other Webex Agents or additional ports, ie. 9000, simply by re-deploying the Webex Template. The Webex Server and Webex DNS tests will not be impacted when you deploy multiple times. You can use the 'Target Region' field to append a unique region identifier to your Voice and Video tests so that new voice and video tests get created each time you re-deploy.
{% endhint %}

## Webex Cloud Agent Locations

For current Webex Cloud Agent locations, see [Webex Agents](https://www.thousandeyes.com/product/cloud-agents#webex).