Try using Grot AI Grot AI for this query ->
Promo banner icon

Grafana 12.4 is here — faster and easier data visualization, Git Sync for observability as code updates, and more.

Learn more
DownloadsContact Us
Logo
  • Pricing
  • Docs
Sign inSign up
Menu
Technical documentation Plugin catalog
Choose a product
Viewing: v12.3 Find another version
  • Grafana documentation
  • What's new
    • What's new in Grafana v12.3
    • What's new in Grafana v12.2
    • What's new in Grafana v12.1
    • What's new in Grafana v12.0
    • What's new in Grafana v11.6
    • What's new in Grafana v11.5
    • What's new in Grafana v11.4
    • What's new in Grafana v11.3
    • What's new in Grafana v11.2
    • What's new in Grafana v11.1
    • What's new in Grafana v11.0
    • What's new in Grafana v10.4
    • What's new in Grafana v10.3
    • What's new in Grafana v10.2
    • What's new in Grafana v10.1
    • What's new in Grafana v10.0
    • What's new in Grafana v9.5
    • What's new in Grafana v9.4
    • What's new in Grafana v9.3
    • What's new in Grafana v9.2
  • Breaking changes
    • Breaking changes in Grafana v11.0
    • Breaking changes in Grafana v10.3
    • Breaking changes in Grafana v10.0
  • Upgrade Grafana
    • Upgrade strategies
    • Upgrade to v12.3
    • Upgrade to v12.2
    • Upgrade to v12.1
    • Upgrade to v12.0
    • Upgrade to v11.6
    • Upgrade to v11.5
    • Upgrade to v11.4
    • Upgrade to v11.3
    • Upgrade to v11.2
    • Upgrade to v11.1
    • Upgrade to v11.0
    • Upgrade to v10.4
    • Upgrade to v10.3
    • Upgrade to v10.2
    • Upgrade to v10.1
    • Upgrade to v10.0
    • Upgrade to v9.5
    • Upgrade to v9.4
    • Upgrade to v9.3
    • Upgrade to v9.2
    • Upgrade to v9.1
    • Upgrade to v9.0
    • Upgrade to v8.5
    • Upgrade to v8.4
    • Upgrade to v8.3
    • Upgrade to v8.2
    • Upgrade to v8.1
    • Upgrade to v8.0
  • About Grafana
    • Grafana Enterprise
    • Grafana Cloud
  • Introduction
    • What is Prometheus?
    • Dashboard overview
    • Introduction to time series
    • Time series dimensions
    • Histograms and heatmaps
    • Exemplars
    • Glossary
    • Get started with Grafana Open Source
      • Build your first dashboard
        • Get started with Grafana and Prometheus
        • Get started with Grafana and InfluxDB
        • Get started with Grafana and MS SQL Server
  • Set up
    • Install Grafana
      • Debian or Ubuntu
      • RHEL or Fedora
      • SUSE or openSUSE
      • Grafana Docker image
      • Grafana on Kubernetes
      • Grafana on Helm Charts
      • macOS
      • Windows
    • Configure Grafana
      • Configure Grafana Enterprise
      • Configure feature toggles
      • Configure profiling and tracing
      • Configure custom branding
      • Settings updates at runtime
      • Configure data source proxy
    • Start Grafana
    • Sign in to Grafana
    • Configure security
      • Configure database encryption
        • Encrypt database secrets using Google Cloud KMS
        • Encrypt database secrets using Hashicorp Vault
        • Encrypt database secrets using AWS KMS
        • Encrypt database secrets using Azure Key Vault
        • Integrate Grafana with Hashicorp Vault
      • Audit a Grafana instance
      • Export logs of usage insights
      • Configure secret scanning
      • Configure request security
      • Configure security hardening
    • Configure access management
      • Configure authentication
        • Basic auth
        • Passwordless
        • Anonymous access
        • LDAP
        • LDAP user interface
        • Enhanced LDAP
        • SAML
          • SAML user interface
          • SAML configuration options
          • Configure SAML signing and encryption
          • Configure Role and Team sync for SAML
          • Configure Organisation mapping for SAML
          • Configure SAML single logout
          • Configure SAML with Entra ID
          • Configure SAML with Okta
            • Configure SAML with Okta catalog application
          • Troubleshooting
        • Generic OAuth
        • Entra ID OAuth
        • GitHub OAuth
        • GitLab OAuth
        • Google OAuth
        • Grafana Cloud OAuth2
        • Keycloak OAuth2
        • Multiple providers with Keycloak
        • Okta OIDC
        • Auth proxy
        • JWT
      • Configure SCIM provisioning
        • Manage users and teams with SCIM
        • Configure SCIM with Entra ID
        • Configure SCIM with Okta
        • Troubleshoot SCIM
      • Multi-team access
      • Configure Team Sync
    • Set up Grafana monitoring
    • Set up HA
    • Set up HTTPS
    • Set up image rendering
      • Troubleshooting
      • Flags
    • Set up Grafana Live
    • Configure a Docker image
  • Administration
    • Back up Grafana
    • Data source management
      • Label Based Access Control (LBAC) for data sources
        • Configure LBAC for data sources for Loki
        • Configure LBAC for data sources for Prometheus
        • Create LBAC for data sources rules for a supported data source
    • Plugin management
      • Types of plugins
      • Install a plugin
      • Plugin signatures
      • Customize navigation placement of plugin pages
      • Plugin backend communication
      • Isolate plugin code with the Plugin Frontend Sandbox
    • Grafana Advisor
    • Grafana Teams
      • Configure Grafana Teams
      • Administer Grafana Teams
    • Manage users
      • Server user management
        • Assign or remove Grafana server administrator privileges
        • Add or remove a user in an organization
        • Change a user's organization permissions
      • Manage user preferences
      • Manage users in an organization
      • Manage dashboard permissions
    • Roles and permissions
      • Role-based access control (RBAC)
        • Plan your RBAC rollout strategy
        • Configure RBAC
        • Assign RBAC roles
        • Manage RBAC roles
        • Provisioning RBAC with Grafana
        • Provisioning RBAC with Terraform
        • RBAC role definitions
        • RBAC permissions, actions, and scopes
        • RBAC for app plugins
        • Plugin role definitions
        • Troubleshooting RBAC
    • Manage organizations
    • Organization preferences
    • Admin with Grafana server CLI
    • Provision Grafana
    • Service accounts
      • Migrate API keys
    • Server stats and license
    • Announcement banner
    • Grafana Enterprise license
      • Activate a Grafana Enterprise license purchased through AWS Marketplace
        • Activate a Grafana Enterprise license from AWS Marketplace on EKS
        • Activate a Grafana Enterprise license from AWS Marketplace on ECS
        • Activate a Grafana Enterprise license from AWS on an instance deployed outside of AWS
        • Manage your Grafana Enterprise license in AWS Marketplace
        • Transfer your AWS Marketplace Grafana Enterprise license
    • Correlations
      • Correlation
      • Permissions
      • Add permissions
      • Create a new correlation
      • Use variables and transformations in a correlation
      • Use correlations in visualizations
    • Migrate from Grafana OSS/Enterprise to Grafana Cloud
      • Manually migrate to Grafana Cloud
      • Migrate to Grafana Cloud using the Grafana Cloud Migration Assistant
    • Search
    • Recorded queries (deprecated)
  • Data sources
    • Alertmanager
    • Amazon CloudWatch
      • Configure
      • Query editor
      • Template variables
      • AWS authentication
      • Troubleshooting
    • Azure Monitor
      • Configure
      • Query editor
      • Template variables
      • Annotations
      • Alerting
      • Troubleshooting
    • Elasticsearch
      • Configure
      • Query editor
      • Template variables
      • Annotations
      • Alerting
      • Troubleshooting
    • Google Cloud Monitoring
      • Configure
      • Google authentication
      • Query editor
      • Template variables
      • Annotations
      • Alerting
      • Troubleshooting
    • Graphite
      • Configure
      • Query editor
      • Template variables
      • Troubleshooting
    • InfluxDB
      • Configure
      • Query editor
      • Template variables
      • Troubleshooting
    • Loki
      • Configure Loki
      • Query editor
      • Template variables
    • Jaeger
    • Microsoft SQL Server
      • Configure
      • Query editor
      • Template variables
      • Troubleshooting
    • MySQL
      • Configure
      • Query editor
      • Template variables
      • Annotations
      • Alerting
      • Troubleshooting
    • OpenTSDB
      • Configure
      • Query editor
      • Template variables
      • Alerting
      • Annotations
      • Troubleshooting
    • Parca
    • PostgreSQL
      • Configure
      • Query editor
      • Template variables
      • Annotations
      • Alerting
      • Troubleshooting
    • Prometheus
      • Configure
        • Authenticating with SigV4
        • Authenticating with Azure
      • Query editor
      • Template variables
      • Troubleshooting
    • Pyroscope
      • Configure Pyroscope
      • How profiling and tracing work together
      • Configure traces to profiles
      • Query profile data
    • Tempo
      • Configure Tempo
      • Best practices
      • Use traces in Grafana
        • Link to a trace ID
        • Upload JSON trace file
        • Trace correlations
      • Query tracing data
        • TraceQL query structure
        • Search traces
        • Write TraceQL queries
      • Service Graph and Service Graph view
      • Span filters
    • TestData
    • Zipkin
  • Alerting
    • Introduction
      • Alert rules
        • Queries and conditions
        • Labels and annotations
      • Alert rule evaluation
        • No Data and Error states
        • Stale alert instances
        • Alert rule state and health
        • Evaluation within a group
      • Notifications
        • Contact points
        • Notification policies
        • Grouping
      • Templates
    • Configure alert rules
      • Configure Grafana-managed alert rules
      • Create and link alert rules to panels
      • Import to Grafana-managed rules
      • Configure data source-managed alert rules
      • Create recording rules
        • Create Grafana-managed recording rules
        • Create data source-managed recording rules
        • Migrate recorded queries
      • Template annotations and labels
        • Template reference
        • Examples
        • Template language
    • Configure notifications
      • Configure contact points
        • Alertmanager
        • Amazon SNS
        • Discord
        • Email
        • Google Chat
        • Grafana IRM
        • Jira
        • Microsoft Teams
        • MQTT
        • Opsgenie
        • PagerDuty
        • Slack
        • Telegram
        • Webhook
      • Configure notification policies
      • Configure mute timings and active time intervals
      • Configure silences
      • Template notifications
        • Manage templates
        • Template reference
        • Examples
        • Template language
        • Use images
    • Monitor alerts
      • Alerts overview page
      • View alert rules
      • View alert state
      • View alert state history
      • View active notifications
      • Declare incidents from firing alerts
    • Additional configuration
      • Configure roles and permissions
      • Configure RBAC
        • Manage access using roles
        • Manage access using folders or data sources
      • Configure Alertmanagers
      • Configure alert state history
      • Provision Alerting resources
        • Use configuration files to provision
        • Use Terraform to provision
        • Export alerting resources
        • Use the HTTP API to manage alerting resources
      • Configure high availability
      • Meta monitoring
      • Performance considerations and limitations
    • Guides
      • Best practices
      • Handle connectivity errors
      • Handle missing data
    • Examples
      • Multi-dimensional alerts
      • Table data
      • Trace-based alerts
      • Dynamic labels
      • Dynamic thresholds
      • High-cardinality alerts
      • Tutorials
  • Troubleshooting
    • Send panel to support
    • Send a support bundle to support
    • Generate a HAR capture
  • Visualize data
    • Dashboards
      • Use dashboards
      • Build dashboards
        • Create a dashboard
        • Import dashboards
        • Modify dashboard settings
        • Manage dashboard links
        • Dashboard URL variables
        • Manage library panels
        • Manage version history
        • Annotate visualizations
        • JSON model
        • Best practices
      • Manage dashboards
      • Search dashboards
      • Manage playlists
      • Reporting
        • Settings
      • Sharing
        • Shared dashboards
      • Variables
        • Add variables
        • Inspect variables
        • Variable syntax
      • Assess dashboard usage
      • Troubleshoot dashboards
    • Panels and visualizations
      • Visualizations
        • Time series
        • Alert list
        • Annotations list
        • Bar chart
        • Bar gauge
        • Candlestick
        • Canvas
        • Dashboard list
        • Datagrid
        • Flame graph
        • Gauge
        • Geomap
        • Heatmap
        • Histogram
        • Logs
        • News
        • Node graph
        • Pie chart
        • Stat
        • State timeline
        • Status history
        • Table
        • Text
        • Traces
        • Trend
        • XY chart
      • Panel overview
      • Panel editor
      • The panel inspect view
      • Query and transform data
        • Write expression queries
        • SQL expressions
        • Share query results
        • Transform data
        • Troubleshoot queries
        • Calculation types
      • Configure panel options
      • Configure standard options
      • Configure a legend
      • Configure tooltips
      • Configure data links and actions
      • Configure value mappings
      • Configure thresholds
      • Configure field overrides
    • Explore
      • Get started with Explore
      • Query management in Explore
      • Query inspector in Explore
      • Correlations Editor in Explore
      • Logs in Explore
      • Traces in Explore
    • Drilldown
      • Logs Drilldown
        • Access or Install
          • Configure
        • Get started
        • View logs
        • Labels and fields
        • Log patterns
        • Viewing JSON logs
        • Sorting and ordering
        • Troubleshooting
      • Profiles Drilldown
        • Access or install
          • Profile settings
        • Concepts
          • What is profiling?
          • Continuous profiling
          • Understand profiling types
          • Flame graphs
        • Get started
        • Determine your use case
        • Choose a view
        • Investigate trends and spikes
          • Use Flame graph AI
      • Traces Drilldown
        • Access or install
        • Concepts
          • Traces and telemetry
          • Trace structure
          • Visualize data
          • Glossary
        • Get started
          • Investigation walkthrough
        • Determine your use case
        • Investigate trends and spikes
          • Choose span data
          • Choose a RED metric
          • Analyze tracing data
          • Add filters
          • View exemplars
          • Save and load queries
        • UI reference
      • Grafana Metrics Drilldown
        • About metrics and telemetry
        • Get started
        • Drill down your metrics
  • As code
    • Observability as code
      • Grafana CLI
        • Install Grafana CLI
        • Set up Grafana CLI
        • Manage resources with Grafana CLI
      • Foundation SDK
        • Foundation SDK key concepts
        • Automate dashboard provisioning with CI/CD
      • Git Sync
        • Key concepts
        • Usage limitations
        • Set up Git Sync
          • Setup prerequisites
          • Set up Git Sync as code
          • Instantaneous pulling and dashboard previews
        • Add non-provisioned resources
        • Work with provisioned repositories
        • Work with provisioned dashboards
        • Deployment scenarios
          • Single instance
          • Across environments
          • Regional replication
          • High availability
          • Shared instance
      • On-prem file provisioning
        • Set up file provisioning
      • JSON schema v2
        • annotations schema
        • PanelKind schema
        • LibraryPanelKind schema
        • layout schema
        • links schema
        • timesettings schema
        • variables schema
    • Infrastructure as code
      • Terraform
        • Creating and managing a Grafana Cloud stack using Terraform
        • Creating and managing dashboards using Terraform and GitHub Actions
        • Manage Grafana IRM in Grafana Cloud using Terraform
        • Manage Knowledge Graph in Grafana Cloud using Terraform
          • Get started
          • Notification alerts
          • Suppressed assertions
          • Custom model rules
          • Log configurations
          • Thresholds
          • Knowledge graph SLOs
        • Manage Fleet Management in Grafana Cloud using Terraform
        • Manage Frontend Observability in Grafana Cloud with Terraform
        • Manage Cloud Provider Observability in Grafana Cloud using Terraform
        • Install plugins in Grafana Cloud using Terraform
      • Ansible
        • Manage stack using Ansible
      • Grafana Operator
        • Manage resources with the Grafana Operator
        • Manage dashboards with ArgoCD
      • Grizzly (deprecated)
  • Developer resources
    • HTTP API
      • Authentication
      • Examples
        • API Tutorial: Create Service Account tokens and dashboards for an organization
        • cURL examples
      • Admin HTTP API
      • Alerting Provisioning HTTP API
      • Annotations HTTP API
      • Correlations HTTP API
      • Dashboard HTTP API
      • Dashboard Permissions HTTP API
      • Dashboard Versions HTTP API
      • Data source HTTP API
      • Datasource LBAC rules HTTP API
      • Datasource Permissions HTTP API
      • Folder HTTP API
      • Folder Permissions HTTP API
      • Folder/Dashboard Search HTTP API
      • Library Element HTTP API
      • Licensing HTTP API
      • New API Structure
      • Organization HTTP API
      • Other HTTP API
      • Playlist HTTP API
      • Preferences API
      • Query and Resource Caching HTTP API
      • Query History HTTP API
      • RBAC HTTP API
      • Reporting API
      • Secrets Management HTTP API
      • Service account HTTP API
      • Shared Dashboards HTTP API
      • Short URL HTTP API
      • Snapshot API
      • SSO Settings API
      • Team HTTP API
      • Team Sync HTTP API
      • User HTTP API
    • Grafana Cloud API
    • Tracing API reference
    • Contribute to Grafana
    • Contributor License Agreement (CLA)
  • Copyright notice
Scroll for more

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Visualize databreadcrumb arrow Dashboardsbreadcrumb arrow Build dashboards
Grafana Cloud Enterprise Open source RSS

Build dashboards

Note: Looking for prebuilt Grafana dashboards? Check out our full library of dashboards and more →

This section includes the following topics:

  • Create a dashboard
  • Import dashboards
  • Modify dashboard settings
  • Manage dashboard links
  • Dashboard URL variables
  • Manage library panels
  • Manage dashboard version history
  • Annotate visualizations
  • JSON model
  • Grafana dashboard best practices

Was this page helpful?

Create a GitHub issue
Email docs@grafana.com
Help and support
Community

Related resources from Grafana Labs

Additional helpful documentation, links, and articles:
video icon
Video
Getting started with managing your metrics, logs, and traces using Grafana
Getting started with managing your metrics, logs, and traces using Grafana
In this webinar, we’ll demo how to get started using the LGTM Stack: Loki for logs, Grafana for visualization, Tempo for traces, and Mimir for metrics.
webinar icon
Video
Getting started with Grafana dashboard design
Getting started with Grafana dashboard design
In this webinar, you'll learn how to design stylish and easily accessible Grafana dashboards that tell a story.
webinar icon
Video
Building advanced Grafana dashboards
Building advanced Grafana dashboards
In this webinar, we’ll demo how to build and format Grafana dashboards.

Is this page helpful?

Still have questions?

Ask your questions. Let AI do the heavy lifting.

Ask AI icon
Newsletter icon

Get every update

Subscribe to our newsletter

By submitting, you agree to our Privacy policy

Grafana Cloud

  • Overview
  • Pricing
  • What's in the free tier?
  • AI Assistant
  • Application Observability
  • Kubernetes Monitoring
  • Dashboards & Visualization
  • Database Observability
  • Frontend Observability
  • Synthetic Monitoring
  • Performance & Load Testing
  • Incident Response & Management
  • What’s New
  • Grafana Cloud Status

Solutions

  • AI Observability
  • Full-Stack Observability
  • Infrastructure & Cloud Observability
  • Digital Experience Monitoring
  • Scaled Prometheus
  • Cost Management & Optimization
  • Site Reliability
  • Log Management
  • Migrate to OpenTelemetry

Integrations

  • All Integrations
  • AWS
  • Google Cloud
  • Microsoft Azure
  • Kubernetes
  • Datadog
  • New Relic

Open Source

  • Our Projects
  • GitHub
  • Downloads
  • Dashboard Templates

Learn

  • Documentation
  • Blog
  • Community
  • Events
  • Observability Survey & Reports

Company

  • About Grafana Labs
  • Open Positions
  • Partnerships
  • Newsroom
  • Success Stories
  • Contact Us
  • Getting Help
  • Professional Services
  • Hey AI

Compare

  • Datadog vs. Grafana Labs
  • Dynatrace vs Grafana Cloud
  • Elasticsearch vs Grafana Cloud
  • New Relic vs Grafana Cloud
  • PagerDuty vs Grafana Cloud
  • Splunk vs Grafana Cloud
Grafana Labs x unique logomark

Donut take our word for it. Try Grafana Cloud today.

Grafana Cloud StatusLegal & SecurityTerms of ServicePrivacy PolicyTrademark Policy

Copyright 2026 © Grafana Labs

FacebookXLinkedinGithubYoutubeReddit
Grafana Labs uses cookies for the normal operation of this website. Learn more.