Devices

Devices has both it’s own special page in our app, but also can be used as generic search/filter/split/group by fields.

Devices special page

Browse > Devices

Here’s what you might get if you Browse > Devices

typical results from browse devices

 

Device Detail

Clicking on any row in Browse > Devices will take you to a page that gives you more information on that Device.

typical detail page for a device

Devices general use

Find Device Fields

  • In the app click the “Home” in the upper left.
  • In the bottom half of the home screen pick “Devices”
    searching for fields in home
  • There are a lot of device fields available, so take a look!
  • Generally, fields that start with orig_device are originating device information that we create in the app
  • And ones that start with dest_device are destination device information that we create in the app
  • If it doesn’t have either orig or dest, it’s a rollup of “all the devices on that call”.
  • The ones with camel case, like origDeviceName are ones that Cisco provides.

See our blog post on the Field Gallery for more information.

Displaying the fields in Browse Calls

These fields are enabled by default. To see them in Browse Calls, simply add them with the field picker.

  1. Click Edit Fields in the upper right.
  2. Find the field you want to add either by scrolling around, or use the filter field.
  3. Click to add fields to the Selected Fields list.
  4. Click and drag to rearrange the fields on the right.
  5. Remove extra fields by clicking their “x”.
    adding device fields to the displayed fields

There are a lot of fields available here, we’re only adding a few so we don’t overload the screen.

Simple Filtering on Group/Subgroup in Browse Calls

Use the search filters box to filter Browse Calls to a particular device, orig_device, dest_device, dest_device_port or any other of the fields.

For instance, here I’m looking for any calls that started from a regular “desk phone” : orig_device_type="hardphone"

shows simple filtering of browse calls with device information

Similarly, you could

  • Filter to multiple device types, like device_type="hardphone" AND device_type!="gateway", which shows only calls where at least one leg was on a hardphone, and where no legs for that call went across a gateway.
  • Exclude a particular originating gateway slot, like NOT orig_gateway_slot="S0"
  • Include all calls that crossed a destDeviceName that contained “somecorp.com” like destDeviceName="*somecorp.com"

These search filters follow you though to General Report if you click the “Graph calls over time” link in the upper right.

Using in General Report

There are a several options for using this information in General Report.

Using it as a search “filter”

One way is to add a filter (using the search field) to filter to just one or more sites.  Here we add a search term to include only regular “desk phone” results. orig_device_type="hardphone"

 

General report with search filter of orig_device_type="hardphone"

Similarly, you could

  • Filter to multiple device types, like device_type="hardphone" AND device_type!="gateway", which shows only calls where at least one leg was on a hardphone, and where no legs for that call went across a gateway.
  • Exclude a particular originating gateway slot, like NOT orig_gateway_slot="S0"
  • Include all calls that crossed a destDeviceName that contained “somecorp.com” like destDeviceName="*somecorp.com"

These search filters follow you though to Browse Calls if you click the “see calls” link in the upper right.

Using it as a “over” or “split by” field

Another way is to use it in the over field.  This is usually better as a column chart because it will then make buckets of each field’s contents and count how many were in each bucket.

Here we’ve included a search filter – this is optional, but entirely possible.  In this case we’re using that to exclude all gateways from this list, leaving just … non-gateways.

General report with an "over" field of orig_device_type with optional simple filter

 

And the last example is of using it in the split by field.  Here, instead of building buckets like above, we just split the overall totals into “by orig_device_type”.  A picture is worth a thousand words here.

An example of General Report being used with a split by field.

There are other ways you can use this information too, we’ve only give you the tip of the iceberg in this documentation.





If you have any comments at all about the documentation, please send it in to docs@sideviewapps.com.