Chat now with support
Chat with Support

Foglight 5.9.5 - Web Component Guide

Introducing the Web Component Framework The Web Component Framework Configuring Views and Context Queries Functions Bindings Additional Components

Queries

In Foglight®, queries are the preferred method for retrieving data from a data source. For example, you can set up a query to retrieve a list of objects that represent all agent instances running in a monitored environment whose host name matches the name of a particular Host object.

The objects that appear in the Data menu choice under Configuration are those that are returned by root queries. A number of default Root Queries have been defined. These allow you to browse the common data objects. Using this approach you can build your own query that returns objects of interest to you and drag them on to your custom dashboard to create pages that meet your specific needs.

These topics discuss how to work with query definitions and provide explanations of the choices a user encounters.

Overview of Query Definitions

Queries let you select a set of data objects of the same type. Pages and views extract and use data from the queries for values and context settings.

Each query defines:

Optionally, a query can search from the root, drilling down until it finds objects of the desired type. In addition, it can restrict the objects it finds using conditions (or restrict them to the first N objects), it can sort the objects, and it can aggregate the objects into maximums, minimums, averages, and other aggregates.

Queries return a list of data objects of the same data type (such as Host or Alarm). For example, a query on the Host data type may return a list that contains all the available Host data objects from the data source.

Queries always return a list of data objects. Even when there is only one object found that satisfies the query, the result is a one-element list. A query that does not find any objects returns an empty list.

Just like Views, Relevant and Allowed Roles can be set on Query Definitions. These are taken into account when filtering Root Queries by role in the Data Browser and when using Create dashboard or Create report. For more information, see Roles in Query Definitions.

Creating a Query in Foglight

You begin the process of creating a query by clicking the Add button after selecting Queries in the drop-down list in the Module Contents pane. The Add Query dialog box appears with these choices:

Create a Blank Query: Invokes the editor to create a new query. Creating New Queries
Copy an Existing Query: Copies a query to a new module. Copying a Query
Derive from an Existing Query: Creates a variant of an existing query with a different name, usually to change some but not all of the original’s definition. Deriving a Query from Another Query

Query Definition Settings

Unlike views, a query definition does not have separate tabs for different groups of settings. All of the settings are on a single page.

Related Documents