Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Marvis Query Language Overview

The Marvis Query Language provides a structured framework for querying Marvis to get data that helps you monitor or troubleshoot your network. You can use queries to quickly find details about an event or failure in your network and about the affected devices.

You can start the query process by clicking the Ask a Question link in the upper-right corner of the Marvis page.

Marvis Query Structure

You can build a query in Marvis easily. You click inside the Enter a query text box to start and Marvis displays the available Query Types. A Query Type defines what you want Marvis to do. You can select each component of the query by following the hint text displayed below the text box. Marvis displays a drop-down list from which you can choose each query element. Each query element you choose determines the subsequent query elements. You can build the query step by step this way until it is complete. When your query is complete, you can run the query by pressing the Enter key.

A query can contain the following elements:

  • Query Type—Defines what you want Marvis to do (for example, COUNT, LIST, RANK, LOCATE, or TROUBLESHOOT).

  • Value—Specifies a unique value that is specific to an organization, such as a client's name.

  • Query Object—Indicates Mist-defined objects (for example, APEvents, ClientEvents)

  • Clause—Acts as a qualifier for the overall query (for example, of, with, or by).

  • Filter Type—Narrows the results based on pre-defined filter types.

You can also add a duration to the end of a Marvis query. Note that you need to press the space bar after entering each element to see the available options.

Here's an example of a RANK query that ranks clients based on the authentication failures:

Marvis Query Structure