LogoLogo
Log in|Playground
  • Welcome
    • Introduction
    • FAQ
  • Capabilities
    • Log Management
    • Infrastructure Monitoring
    • Application Performance Monitoring (APM)
      • Application Metrics
      • Traces
      • Supported Technologies
    • Real User Monitoring (RUM)
  • Getting Started
    • Requirements
      • Kubernetes requirements
      • Kernel requirements for eBPF sensor
      • CPU architectures
      • ClickHouse resources
    • Installation & updating
    • Connect Linux hosts
    • Connect RUM
    • 5 quick steps to get you started
    • groundcover MCP
  • Use groundcover
    • Monitors
      • Create a new Monitor
      • Issues page
      • Monitor List page
      • Silences page
      • Monitor Catalog page
      • Monitor YAML structure
      • Embedded Grafana Alerts
        • Create a Grafana alert
    • Dashboards
      • Create a dashboard
      • Embedded Grafana Dashboards
        • Create a Grafana dashboard
        • Build alerts & dashboards with Grafana Terraform provider
        • Using groundcover datasources in a Self-hosted Grafana
    • Insights
    • Explore & Monitors query builder
    • Workflows
      • Create a new Workflow
      • Workflow Examples
      • Alert Structure
    • Search & Filter
    • Issues
    • Role-Based Access Control (RBAC)
    • Service Accounts
    • API Keys
    • APIs
    • Log Patterns
    • Drilldown
    • Scraping custom metrics
      • Operator based metrics
      • kube-state-metrics
      • cadvisor metrics
    • Backup & Restore Metrics
    • Metrics & Labels
    • Add custom environment labels
    • Configuring Pipelines
      • Writing Remap Transforms
      • Logs Pipeline Examples
      • Traces Pipeline Examples
      • Logs to Events Pipeline Examples
      • Logs/Traces Sensitive Data Obfuscation
      • Sensitive Data Obfuscation using OTTL
      • Log Filtering using OTTL
    • Querying your groundcover data
      • Query your logs
        • Example queries
        • Logs alerting
      • Query your metrics
      • Querying you data using an API
      • Using KEDA autoscaler with groundcover
  • Log Parsing with OpenTelemetry Pipelines
  • Log and Trace Correlation
  • RUM
  • Customization
    • Customize deployment
      • Agents in host network mode
      • API Key Secret
      • Argo CD
      • On-premise deployment
      • Quay.io registry
      • Configuring sensor deployment coverage
      • Enabling SSL Tracing in Java Applications
    • Customize usage
      • Filtering Kubernetes entities
      • Custom data retention
      • Sensitive data obfuscation
      • Custom storage
      • Custom logs collection
      • Custom labels and annotations
        • Enrich logs and traces with pod labels & annotations
        • Enrich metrics with node labels
      • Disable tracing for specific protocols
      • Tuning resources
      • Controlling the eBPF sampling mechanism
  • Integrations
    • Overview
    • Workflow Integrations
      • Slack Webhook Integration
      • Opsgenie Integration
      • Webhook Integration
        • Incident.io
      • PagerDuty Integration
      • Jira Webhook Integration
      • Send groundcover Alerts to Email via Zapier
    • Data sources
      • OpenTelemetry
        • Traces & Logs
        • Metrics
      • Istio
      • AWS
        • Ingest CloudWatch Metrics
        • Ingest CloudWatch Logs
        • Ingest Logs Stored on S3
        • Integrate CloudWatch Grafana Datasource
      • GCP
        • Ingest Google Cloud Monitoring Metrics
        • Stream Logs using Pub/Sub
        • Integrate Google Cloud Monitoring Grafana Datasource
      • Azure
        • Ingest Azure Monitor Metrics
      • DataDog
        • Traces
        • Metrics
      • FluentBit
      • Fluentd
      • JSON Logs
    • 3rd-party metrics
      • ActiveMQ
      • Aerospike
      • Cassandra
      • CloudFlare
      • Consul
      • CoreDNS
      • Etcd
      • HAProxy
      • Harbor
      • JMeter
      • K6
      • Loki
      • Nginx
      • Pi-hole
      • Postfix
      • RabbitMQ
      • Redpanda
      • SNMP
      • Solr
      • Tomcat
      • Traefik
      • Varnish
      • Vertica
      • Zabbix
    • Source control (Gitlab/Github)
  • Architecture
    • Overview
    • inCloud Managed
      • Setup inCloud Managed with AWS
        • AWS PrivateLink Setup
        • EKS add-on
      • Setup inCloud Managed with GCP
      • Setup inCloud Managed with Azure
      • High Availability
      • Disaster Recovery
      • Ingestion Endpoints
      • Deploying in Sensor-Only mode
    • Security considerations
      • Okta SSO - onboarding
    • Service endpoints inside the cluster
  • Product Updates
    • What's new?
    • Earlier updates
      • 2025
        • Mar 2025
        • Feb 2025
        • Jan 2025
      • 2024
        • Dec 2024
        • Nov 2024
        • Oct 2024
        • Sep 2024
        • Aug 2024
        • July 2024
        • May 2024
        • Apr 2024
        • Mar 2024
        • Feb 2024
        • Jan 2024
      • 2023
        • Dec 2023
        • Nov 2023
        • Oct 2023
Powered by GitBook
On this page
  • How to create a new Dashboard in groundcover?
  • Create a new Widget
  • Choose a Widget Type
  • Select a Widget Mode
  • Build your query
  • Choose a Display Type
  • Variables
  • Adding a Variable
  • Using a Variable
Export as PDF
  1. Use groundcover
  2. Dashboards

Create a dashboard

Last updated 3 months ago

Note: Only users with Write or Admin permissions can create and edit dashboards.

How to create a new Dashboard in groundcover?

  1. Navigate to the Dashboard List and click on the Create New Dashboard button.

  2. Provide an indicative name for your dashboard and, optionally, a description.

Steps to creating a Dashboard

  1. Create a new widget

  2. Choose a Widget Type

  3. Select a Widget Mode

  4. Build your query

  5. Choose a Display Type

  6. Save the widget

Optional:

  1. Add variables

  2. Apply variable(s) to the widget

Create a new Widget

Widgets can be added by clicking on the Create New Widget button.

Choose a Widget Type

Widgets are the main building blocks of dashboards. groundcover supports the following widget types:

  • Chart Widget: Visualize your data through various display types.

  • Textual Widget: Add context to your dashboard, such as headers or instructions for issue investigations.

Since selecting a Textual Widget is the last step for this type of widget, the rest of this guide is relevant only to Chart Widgets.

Select a Widget Mode

  • Metrics: Work with all your available metrics for advanced use cases and custom metrics.

  • Infra Metrics: Use expert-built, predefined queries for common infrastructure scenarios. Ideal for quick starts.

  • Logs: Query and visualize log data.

  • Traces: Query and visualize trace data similar to logs.

Build your query

Once the Widget Mode selected, build your query for the visualization.

If you're unfamiliar with query building in groundcover, refer to the Query Builder section for full details on the different components.

Choose a Display Type

Type
Configuration options
Supported modes

Time Series

Choose a Y-axis unit from the predefined list.

Select a visualization type: Stacked Bar or Line Chart.

Metrics

Infra Metrics

Logs

Traces

Table

Define columns based on data fields or metrics.

Choose a Y-axis unit from the predefined list.

Metrics

Infra Metrics

Logs

Traces

Stat

Select a Y-axis unit from the predefined list.

Metrics

Infra Metrics

Logs

Traces

Top List

Choose a ranking metric and sort order.

Logs

Traces

Pie

Select a data source and aggregation method.

Logs

Traces

Variables

Variables dynamically filter your entire dashboard or specific widgets with just one click. They consist of a key-value pair that you define once and reuse across multiple widgets.

Our predefined variables cover most use cases, but if you’re missing an important one, let us know. Advanced variables are also on our roadmap.

Adding a Variable

  1. Click on Add Variable.

  2. Select the variable key and values from the predefined list.

  3. Optionally, rename the variable or use the default name, then click Create.

  4. Once created, select the values to apply to this variable.

Using a Variable

Variables can be referenced in the Filter Bar of the Widget Creation Modal using their name.

  1. Create a variable (for example, select Clusters from the predefined list, and name it 'clusters')

  2. While creating or editing a Chart Widget, add a reference to the variable using a dollar sign in the filter bar, (for example, $clusters).

  3. The data will automatically filter by the variable's key with the selected values. If all values are selected, the filter will be followed by an asterisk (for example, cluster:*)