Explore your metrics

groundcover supports a wide variety of metrics - APM and Infrastructure metrics are automatically generated using our eBPF sensor, and custom metrics can be ingested natively.

The "Explore" section of our platform is the best place to start exploring your metrics data.

Querying metrics

All types of metrics stored in groundcover can be queried using two modes:

• Query Builder - a user-friendly, error-proof way to build the most popular queries using the UI.

• Advanced Query - for experienced users that want to go beyond our query presets and use any supported PromQL query.

Time and Backend Pickers

Use the Time Picker to choose the time range for the graphs, and the Backend Picker to select the instance.

Selecting or deselecting Clusters and Environments in the Backend Picker won't affect the metrics displayed.

Query Builder

The Query Builder supports a limited set of operations, which should cover most of your use cases. If you need additional functionality, we'd love to hear from you!

Inputs from the Query Builder are translated into PromQL, allowing you to leverage the power of Prometheus without requiring any familiarity with the complex query language.

Each Query Builder instance is composed of the following components:

1. Function

   • You can choose a function to apply to the metric:

     1. rate - Calculates the rate of increase for a given counter over a specified time interval.

     2. increase - Shows the total increase in a counter over a specified time interval.

     3. No Function - If no function is selected, the raw metric data will be used.

2. Metric

   • Select a metric from the available list. For the full metrics supported by groundcover, check out our Metrics and Labels Documentation.

   • Each metric comes with its own set of labels and metadata.

3. Condition

   • Define conditions to filter the metric data. These are equivalent to PromQL conditions, allowing you to narrow down the scope of your query.

   • Available filters:

     1. key:value - Filter on a specific field.

     2. key:value - Exclude a specific field.

     3. key:*value* - Supports wildcards for flexible matching.

4. Aggregation Function

   • You can choose an aggregation function to combine data across different labels:

     1. avg - Computes the average value.

     2. sum - Sums all values.

     3. min - Finds the minimum value.

     4. max - Finds the maximum value.

5. Aggregation Fields

   • Specify the labels to aggregate by. If left empty, all data points will be grouped together.

   • You can select from the list of available labels, allowing you to determine how the data is grouped and aggregated.

Advanced Query

Switching to Advanced Query mode allows you to view and modify the PromQL query generated by the Query Builder. This mode provides full flexibility for advanced users. However, changes made in the editor are not reflected back in the Query Builder. The editor is ideal for making manual adjustments that are beyond the capabilities offered in Query Builder mode.

At this time, dashboards you build in the Explore section can't be saved. However, bookmarking the URL allows you to save the Explore page with all the queries you currently have on-screen, so you can come back it anytime and share it with anyone.

Examples of useful queries

To view CPU usage across all namespaces:

• Function: rate

• Metric: groundcover_container_cpu_usage_rate_millis

• Aggregation Function: avg by (namespace)

To view the total disk space for nodes in the US regions, excluding a specific node:

• Function: No Function

• Metric: groundcover_node_disk_space_total_bytes

• Condition: node:node-1, region:*us-*

• Aggregation Function: sum

To view the memory usage percentage for all nodes, filtered by region:

• Function: No Function

• Metric: groundcover_node_mem_used_percent

• Condition: type:worker, region:*eu-*

• Aggregation Function: avg by (node_name)

To view the total PVC usage for a specific namespace:

• Function: No Function

• Metric: groundcover_pvc_usage_bytes

• Condition: namespace:prod

• Aggregation Function: sum by (name)

To view the total bytes received by workloads using HTTP protocol:

• Function: No Function

• Metric: groundcover_network_rx_bytes_total

• Condition: protocol:HTTP

• Aggregation Function: sum by (workload_name)