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: v9.0 Find another version
  • Grafana documentation
  • What's new
  • Introduction to Grafana
    • Grafana Enterprise
    • Grafana Cloud
  • Setup
    • Install Grafana
      • Install on Debian or Ubuntu
      • Run Grafana Docker image
      • Deploy Grafana on Kubernetes
      • Install on RPM-based Linux
      • Install on Windows
      • Install on macOS
    • Configure Grafana
      • Configure Grafana Enterprise
      • Configure tracing
      • Configure custom branding
    • Restart Grafana
    • Sign in to Grafana
    • Upgrade Grafana
    • Configure security
      • Configure authentication
        • Configure generic OAuth authentication
        • Configure Google OAuth2 Authentication
        • Configure JWT Authentication
        • Configure Azure AD OAuth2 authentication
        • Configure GitLab OAuth2 Authentication
        • Configure LDAP Authentication
        • Configure enhanced LDAP integration
        • Configure Grafana authentication
        • Configure SAML authentication
        • Configure Okta OAuth2 authentication
        • Configure auth proxy authentication
        • Configure GitHub OAuth2 Authentication
      • 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 Team Sync
      • Configure request security
    • Set up Grafana monitoring
    • Set up Grafana for high availability
    • Set up HTTPS
    • Set up image rendering
      • Monitoring the image renderer
      • Troubleshooting
    • Set up Grafana Live
    • Configure Docker image
  • Get started
    • Build your first dashboard
    • Get started with Grafana and Prometheus
    • Get started with Grafana and InfluxDB
    • Get started with Grafana and MS SQL Server
  • Grafana basics
    • Exemplars
      • View exemplar data
    • Intro to time series
    • Time series dimensions
    • Histograms and heatmaps
    • Glossary
  • Best practices
    • Best practices for creating dashboards
    • Best practices for managing dashboards
    • Common observability strategies
    • Dashboard management maturity model
  • Administration
    • Data source management
    • Manage organizations
    • User management
      • Server user management
        • Assign or remove Grafana server administrator privileges
        • Add or remove a user in an organization
        • Change a user's organization permissions
        • Grant editors administrator 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
        • RBAC provisioning
        • RBAC role definitions
        • RBAC permissions, actions, and scopes
    • Stats and license
    • Team management
    • Enterprise licensing
      • Enterprise licenses 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
    • Organization preferences
    • Plugin management
    • Provision Grafana
    • API keys
    • Service accounts
  • Data sources
    • Add data source
    • Alertmanager
    • AWS CloudWatch
      • Authentication
      • Template variables in CloudWatch query
      • Curated CloudWatch dashboards
      • Provision CloudWatch
    • Azure Monitor
      • Azure Monitor template variables
      • Provisioning Azure Monitor
      • Application Insights deprecation
    • Elasticsearch
    • Google Cloud Monitoring
      • Authentication
      • Preconfigured dashboards
    • Data source permissions
    • Graphite
    • InfluxDB data source
      • Flux support in Grafana
      • InfluxDB templates
      • Provision InfluxDB
    • Jaeger
    • Loki
    • Microsoft SQL Server
    • MySQL
    • OpenTSDB
    • PostgreSQL
    • Prometheus
    • Tempo
    • TestData
    • Zipkin
  • Panels
    • Configure standard options
    • Working with Grafana panels
      • Organize a dashboard
      • Navigate the Grafana Inspector panel
      • Download query results
    • Configure panel options
    • Query a data source
      • About queries
      • Navigate the query tab
      • Add a query
      • Use expressions to manipulate data
        • About expressions
        • Write an expression
      • Manage queries
      • Share query results with another panel
      • Download raw query results
      • Inspect query performance
      • Inspect query request and response data
    • Configure visualization thresholds
    • Configure data links
    • Override field values
      • About field overrides
      • View field overrides
      • Add a field override
      • Edit a field overrides
      • Delete a field override
    • Transform data
      • About transformations
      • Add a transformation to data
      • Debug a transformation
      • Delete a transformation
      • Transformation functions
    • Format data using value mapping
      • About value mapping
      • Map a value
      • Map a range
      • Map a regular expression
      • Map a special value
      • Edit a value mapping
    • Query options
    • Calculation types
  • Visualizations
    • Alert list
    • Annotations
    • Bar chart
    • Bar gauge
    • Dashboard list
    • Gauge
    • Graph (old)
    • Candlestick
    • Geomap
    • Heatmap
    • Histogram
    • Logs panel
    • News
    • Node graph
    • Pie chart
    • Traces
    • Stat
    • State timeline
    • Status history
    • Table
    • Text
    • Time series
    • Configure a legend
  • Dashboards
    • Use dashboards
    • Add and organize panels
    • Manage library panels
    • Dashboard Folders
    • Manage dashboards
    • Annotations
    • Dashboard previews
    • Playlist
    • Reporting
    • Time range controls
    • Dashboard version history
    • Manage dashboard links
    • Export and import
    • JSON model
    • Scripted dashboards
  • Sharing
    • Share a dashboard
    • Share a panel
  • Explore
    • Query management
    • Logs in Explore
    • Tracing in Explore
    • Inspector in Explore
  • Alerting
    • Upgrade to Grafana Alerting
      • Opt out of Grafana Alerting
      • Roll back to legacy alerting
      • Opt in to Grafana Alerting
      • Disable alerting in Grafana
      • Differences and limitations
    • Alerting fundamentals
      • Data sources
      • Alert rules
        • Alert rule types
        • Alert instances
        • Organising alert rules
      • Alerting on numeric data
      • Alertmanager
      • Annotations and labels for alerting rules
        • How to template annotations and labels
        • Label matchers
        • Labels in Grafana Alerting
        • Template functions
        • Examples of template functions
      • State and health of alerting rules
    • Create and manage rules
      • Create Grafana managed alert rule
      • Create Grafana Mimir or Loki managed alert rule
      • Create Grafana Mimir or Loki managed recording rule
      • Manage alert rules
      • Grafana Mimir or Loki rule groups and namespaces
    • Contact points
      • Add contact point
      • Edit contact point
      • Test a contact point
      • Delete a contact point
      • Edit contact point
      • List of contact point types
        • Webhook notifier
      • Message templating
        • Create message template
        • Edit message template
        • Delete message template
        • Example message template
        • Template data
    • Notification policies
      • Mute timings
    • Alert groups
      • Filter alerts
      • View alert groups
    • Alerting high availability
      • Enable alerting high availability
    • Silences
      • Create a silence
      • Edit silences
      • Create URL to link to silence form
      • Remove silences
    • Limitations
    • Performance considerations
    • Images in notifications
  • Templates and variables
    • Variable syntax
    • Manage variables
    • Inspect variables
    • Add variables
      • Add a query variable
      • Add a custom variable
      • Add a text box variable
      • Add a constant variable
      • Add a data source variable
      • Add an interval variable
      • Add ad hoc filters
      • Chained variables
      • Global variables
    • Variable examples
    • Variable selection options
    • Advanced variable format options
    • Multi-value variables
    • Filter variables with regex
  • Grafana Enterprise
    • Usage insights
      • Dashboard and data source insights
      • Presence indicator
      • Sort dashboards by using insights data
    • Query caching
    • Recorded queries
    • Settings updates at runtime
    • Reporting
    • Export dashboard as PDF
  • Troubleshooting
    • Troubleshoot dashboards
    • Troubleshoot queries
  • Developers
    • HTTP API
      • API Tutorial: Create API tokens and dashboards for an organization
      • Admin HTTP API
      • Alerting HTTP API
      • Alerting Notification Channels HTTP API
      • Alerting Provisioning HTTP API
      • Annotations HTTP API
      • Authentication HTTP API
      • cURL examples
      • Dashboard HTTP API
      • Dashboard Permissions HTTP API
      • Dashboard Versions HTTP API
      • Data source HTTP API
      • Datasource Permissions HTTP API
      • External Group Sync HTTP API
      • Folder HTTP API
      • Folder Permissions HTTP API
      • Folder/Dashboard Search HTTP API
      • HTTP Preferences API
      • HTTP Snapshot API
      • Library Element HTTP API
      • Licensing HTTP API
      • Organization HTTP API
      • Other HTTP API
      • Playlist HTTP API
      • Query History HTTP API
      • RBAC HTTP API
      • Reporting API
      • Service account HTTP API
      • Short URL HTTP API
      • Team HTTP API
      • User HTTP API
    • Contribute to Grafana
    • Contributor License Agreement (CLA)
    • Angular support deprecation
  • Grafana CLI
  • Release notes
  • API Reference
    • @grafana/data
      • AbsoluteTimeRange
      • addDurationToDate
      • addLogLevelToSeries
      • AlertErrorPayload
      • AlertPayload
      • alpha
      • AnnotationEvent
      • AnnotationEventFieldMapping
      • AnnotationEventMappings
      • AnnotationEventUIModel
      • AnnotationQuery
      • AnnotationQueryRequest
      • AnnotationSupport
      • anySeriesWithTimeField
      • AppendedVectors
      • AppEvent
      • AppEvents
      • ApplyFieldOverrideOptions
      • applyFieldOverrides
      • applyRawFieldOverrides
      • AppPlugin
      • AppPluginMeta
      • AppRootProps
      • arrayUtils
      • ArrayVector
      • asHexString
      • AsNumberVector
      • BasicValueMatcherOptions
      • BinaryOperation
      • BinaryOperationID
      • BinaryOperationVector
      • binaryOperators
      • booleanOverrideProcessor
      • booleanValueFormatter
      • BuildInfo
      • BusEventType
      • ByNamesMatcherMode
      • ByNamesMatcherOptions
      • calculateFieldStats
      • calculateInterval
      • calculateLogsLabelStats
      • calculateStats
      • CartesianCoords2D
      • checkLogsError
      • CircularDataFrame
      • CircularVector
      • classicColors
      • colorManipulator
      • Column
      • compareArrayValues
      • compareDataFrameStructures
      • ConfigOverrideRule
      • ConstantVector
      • convertRawToRange
      • CoreApp
      • createDimension
      • CreatePlotOverlay
      • CSVConfig
      • CSVHeaderStyle
      • CSVOptions
      • CSVParseCallbacks
      • CSVReader
      • darken
      • DashboardCursorSync
      • DataConfigSource
      • DataFrame
      • DataFrameDTO
      • DataFrameType
      • DataFrameView
      • DataLink
      • DataLinkBuiltInVars
      • DataLinkClickEvent
      • DataLinksFieldConfigSettings
      • dataLinksOverrideProcessor
      • DataQuery
      • DataQueryError
      • DataQueryErrorType
      • DataQueryRequest
      • DataQueryResponse
      • DataQueryResponseData
      • DataQueryTimings
      • DataSourceApi
      • DataSourceConstructor
      • DataSourceInstanceSettings
      • DataSourceJsonData
      • DataSourceOptionsType
      • DataSourcePlugin
      • DataSourcePluginComponents
      • DataSourcePluginMeta
      • DataSourcePluginOptionsEditorProps
      • DataSourceQueryType
      • DataSourceRef
      • DataSourceSelectItem
      • DataSourceSettings
      • DataSourceWithLogsContextSupport
      • DataTopic
      • DataTransformerConfig
      • DataTransformerID
      • DataTransformerInfo
      • dateMath
      • dateTime
      • dateTimeAsMoment
      • DateTimeBuiltinFormat
      • DateTimeDuration
      • dateTimeFormat
      • dateTimeFormatISO
      • dateTimeFormatTimeAgo
      • dateTimeFormatWithAbbrevation
      • dateTimeForTimeZone
      • DateTimeInput
      • DateTimeLocale
      • DateTimeOptions
      • DateTimeOptionsWhenParsing
      • DateTimeOptionsWithFormat
      • dateTimeParse
      • DecimalCount
      • DecimalInfo
      • decomposeColor
      • DEFAULT_FIELD_DISPLAY_VALUES_LIMIT
      • DEFAULT_SAML_NAME
      • DefaultTimeZone
      • deprecationWarning
      • describeInterval
      • describeTextRange
      • describeTimeRangeAbbreviation
      • Dimension
      • Dimensions
      • Dimensions2D
      • displayNameOverrideProcessor
      • DisplayProcessor
      • DisplayValue
      • DisplayValueAlignmentFactors
      • doStandardCalcs
      • DurationInput
      • durationToMilliseconds
      • DurationUnit
      • DynamicConfigValue
      • emphasize
      • ensureTimeField
      • escapeStringForRegex
      • escapeUnescapedString
      • eventFactory
      • ExploreMode
      • ExplorePanelsState
      • ExploreQueryFieldProps
      • ExploreTracePanelState
      • FALLBACK_COLOR
      • FeatureToggles
      • Field
      • FieldCache
      • FieldCalcs
      • FieldColor
      • FieldColorConfigSettings
      • FieldColorMode
      • FieldColorModeId
      • FieldColorSeriesByMode
      • FieldConfig
      • FieldConfigEditorBuilder
      • FieldConfigEditorConfig
      • FieldConfigEditorProps
      • FieldConfigOptionsRegistry
      • FieldConfigProperty
      • FieldConfigPropertyItem
      • FieldConfigSource
      • FieldDisplay
      • FieldDTO
      • FieldMatcher
      • FieldMatcherID
      • FieldMatcherInfo
      • fieldMatchers
      • FieldNamePickerConfigSettings
      • FieldOverrideContext
      • FieldOverrideEditorProps
      • FieldReducerInfo
      • fieldReducers
      • FieldSparkline
      • FieldType
      • FieldWithIndex
      • findCommonLabels
      • findHighlightChunksInText
      • findMatchesInText
      • findUniqueLabels
      • FlotDataPoint
      • FormatInput
      • formatLabels
      • FormattedValue
      • formattedValueToString
      • FormattedVector
      • FrameMatcher
      • FrameMatcherID
      • FrameMatcherInfo
      • frameMatchers
      • GAUGE_DEFAULT_MAXIMUM
      • GAUGE_DEFAULT_MINIMUM
      • getActiveThreshold
      • getAllValuesFromDimension
      • getColumnFromDimension
      • getColumnsFromDimension
      • getContrastRatio
      • getDataFrameRow
      • getDataSourceRef
      • getDataSourceUID
      • getDefaultRelativeTimeRange
      • getDefaultTimeRange
      • getDimensionByName
      • getDisplayProcessor
      • getDisplayValueAlignmentFactors
      • getFieldColorMode
      • getFieldColorModeForField
      • getFieldDisplayName
      • getFieldDisplayValues
      • GetFieldDisplayValuesOptions
      • getFieldMatcher
      • getFieldTypeFromValue
      • getFlotPairs
      • getFlotPairsConstant
      • getFrameDisplayName
      • getFrameMatchers
      • getLocale
      • getLocaleData
      • getLogLevel
      • getLogLevelFromKey
      • getLuminance
      • getParser
      • getRawDisplayProcessor
      • getScaleCalculator
      • getSeriesTimeStep
      • getTimeField
      • getTimeZone
      • getTimeZoneGroups
      • getTimeZoneInfo
      • getTimeZones
      • getValueFormat
      • getValueFormats
      • getValueFormatterIndex
      • getValueFromDimension
      • getValueMatcher
      • getWeekdayIndex
      • getWeekdayIndexByEnglishName
      • GrafanaPlugin
      • GrafanaTheme
      • GrafanaTheme2
      • GrafanaThemeCommons
      • GrafanaThemeType
      • GraphSeriesValue
      • GraphSeriesXY
      • GroupedTimeZones
      • GroupingToMatrixTransformerOptions
      • guessFieldTypeForField
      • guessFieldTypeFromNameAndValue
      • guessFieldTypeFromValue
      • guessFieldTypes
      • hasLinks
      • hasLogsContextSupport
      • hasMsResolution
      • hexToRgb
      • HistoryItem
      • hslToRgb
      • identityOverrideProcessor
      • IndexVector
      • InternalTimeZones
      • InterpolateFunction
      • intervalToAbbreviatedDurationString
      • intervalToMs
      • intervalToSeconds
      • IntervalValues
      • isBooleanUnit
      • isDataFrame
      • isDataSourceRef
      • isDateTime
      • isFiscal
      • isLiveChannelJoinEvent
      • isLiveChannelLeaveEvent
      • isLiveChannelMessageEvent
      • isLiveChannelStatusEvent
      • isMathString
      • ISO_8601
      • isRelativeTimeRange
      • isTableData
      • isValid
      • isValidDate
      • isValidDuration
      • isValidTimeSpan
      • KeyValue
      • Labels
      • LanguageProvider
      • LayoutMode
      • LayoutModes
      • LegacyEmitter
      • LegacyEventHandler
      • LegacyGraphHoverEventPayload
      • LegacyResponseData
      • LicenseInfo
      • lighten
      • LinkModel
      • LinkModelSupplier
      • LinkTarget
      • LiveChannelConnectionState
      • LiveChannelEvent
      • LiveChannelEventType
      • LiveChannelJoinEvent
      • LiveChannelLeaveEvent
      • LiveChannelMessageEvent
      • LoadingState
      • locale
      • localTimeFormat
      • locationUtil
      • LogLabelStatsModel
      • LogLevel
      • LogRowModel
      • LogsDedupDescription
      • LogsDedupStrategy
      • LogSearchMatch
      • LogsMetaItem
      • LogsMetaKind
      • LogsModel
      • LogsParser
      • LogsParsers
      • LogsSortOrder
      • makeClassES5Compatible
      • mapInternalLinkToExplore
      • matchAllLabels
      • MatcherConfig
      • MatcherID
      • MetadataInspectorProps
      • MetricFindValue
      • MISSING_VALUE
      • msRangeToTimeString
      • MutableDataFrame
      • MutableField
      • MutableVector
      • NavIndex
      • NavLinkDTO
      • NavMenuItemType
      • NavModel
      • NavModelBreadcrumb
      • NavModelItem
      • NavSection
      • NodeGraphDataFrameFieldNames
      • NullValueMode
      • NumberFieldConfigSettings
      • numberOverrideProcessor
      • NumericRange
      • OAuth
      • OAuthSettings
      • objRemoveUndefined
      • onUpdateDatasourceJsonDataOption
      • onUpdateDatasourceJsonDataOptionChecked
      • onUpdateDatasourceJsonDataOptionSelect
      • onUpdateDatasourceOption
      • onUpdateDatasourceResetOption
      • onUpdateDatasourceSecureJsonDataOption
      • onUpdateDatasourceSecureJsonDataOptionSelect
      • OrgRole
      • outerJoinDataFrames
      • PanelData
      • PanelEditorProps
      • PanelEvents
      • PanelMigrationHandler
      • PanelModel
      • PanelOptionEditorsRegistry
      • PanelOptionsEditorBuilder
      • PanelOptionsEditorConfig
      • PanelOptionsEditorItem
      • PanelOptionsEditorProps
      • PanelPlugin
      • PanelPluginDataSupport
      • PanelPluginMeta
      • PanelProps
      • PanelTypeChangedHandler
      • parse
      • parseDateMath
      • parseDuration
      • parseFlags
      • parseLabels
      • PluginBuildInfo
      • PluginConfigPage
      • PluginConfigPageProps
      • PluginDependencies
      • PluginError
      • PluginErrorCode
      • PluginInclude
      • PluginIncludeType
      • PluginMeta
      • PluginMetaInfo
      • PluginSignatureStatus
      • PluginSignatureType
      • PluginState
      • PluginType
      • PreferredVisualisationType
      • preferredVisualizationTypes
      • PreloadPlugin
      • QueryEditorHelpProps
      • QueryEditorProps
      • QueryFix
      • QueryFixAction
      • QueryHint
      • QueryResultBase
      • QueryResultMeta
      • QueryResultMetaNotice
      • QueryResultMetaStat
      • rangeUtil
      • RangeValueMatcherOptions
      • RawTimeRange
      • readCSV
      • ReadWriteVector
      • recomposeColor
      • ReduceDataOptions
      • reduceField
      • ReducerID
      • RegexpOrNamesMatcherOptions
      • Registry
      • RegistryItem
      • RegistryItemWithOptions
      • RenameByRegexTransformerOptions
      • renderMarkdown
      • RenderMarkdownOptions
      • renderTextPanelMarkdown
      • reverseDataFrame
      • rgbToHex
      • roundInterval
      • roundToFiscal
      • scaledUnits
      • ScopedVar
      • ScopedVars
      • ScreenshotInfo
      • secondsToHms
      • SelectableValue
      • SelectFieldConfigSettings
      • selectOverrideProcessor
      • serializeStateToUrlParam
      • SetFieldConfigOptionsArgs
      • setLocale
      • setWeekStart
      • shallowCompare
      • simpleCountUnit
      • SliderFieldConfigSettings
      • SliderMarks
      • sortDataFrame
      • SortedVector
      • sortInAscendingOrder
      • sortInDescendingOrder
      • sortLogRows
      • sortLogsResult
      • sortThresholds
      • sortValues
      • SplitOpen
      • StandardEditorContext
      • StandardEditorProps
      • standardEditorsRegistry
      • StandardEditorsRegistryItem
      • standardFieldConfigEditorRegistry
      • StandardOptionConfig
      • standardTransformers
      • standardTransformersRegistry
      • StatsPickerConfigSettings
      • StringFieldConfigSettings
      • stringFormater
      • stringOverrideProcessor
      • stringStartsAsRegEx
      • stringToJsRegex
      • stringToMs
      • SynchronousDataTransformerInfo
      • systemDateFormats
      • SystemDateFormatSettings
      • SystemDateFormatsState
      • TableData
      • TextMatch
      • textUtil
      • ThemeBreakpoints
      • ThemeBreakpointsKey
      • ThemeColors
      • ThemeShadows
      • ThemeShape
      • ThemeSpacing
      • ThemeTypography
      • ThemeTypographyVariant
      • ThemeZIndices
      • Threshold
      • ThresholdsConfig
      • ThresholdsFieldConfigSettings
      • ThresholdsMode
      • thresholdsOverrideProcessor
      • TIME_FORMAT
      • TIME_SERIES_METRIC_FIELD_NAME
      • TIME_SERIES_TIME_FIELD_NAME
      • TIME_SERIES_VALUE_FIELD_NAME
      • TimeFragment
      • TimeOption
      • TimeOptions
      • TimeRange
      • TimeSeries
      • TimeSeriesPoints
      • TimeSeriesValue
      • TimeZone
      • timeZoneAbbrevation
      • TimeZoneBrowser
      • TimeZoneCountry
      • timeZoneFormatUserFriendly
      • TimeZoneInfo
      • TimeZoneResolver
      • TimeZoneUtc
      • toCSV
      • toDataFrame
      • toDataFrameDTO
      • toDuration
      • toFilteredDataFrameDTO
      • toFixed
      • toFixedScaled
      • toFixedUnit
      • toFloatOrUndefined
      • toIntegerOrUndefined
      • toLegacyResponseData
      • toNumberString
      • toOption
      • toPascalCase
      • toUtc
      • TraceKeyValuePair
      • TraceLog
      • TraceSpanReference
      • TraceSpanRow
      • transformDataFrame
      • TransformerRegistryItem
      • TransformerUIProps
      • unEscapeStringFromRegex
      • UnitFieldConfigSettings
      • unitOverrideProcessor
      • updateDatasourcePluginJsonDataOption
      • updateDatasourcePluginOption
      • updateDatasourcePluginResetOption
      • updateDatasourcePluginSecureJsonDataOption
      • UrlQueryMap
      • UrlQueryValue
      • urlUtil
      • UserOrgDTO
      • validateFieldConfig
      • ValueConverter
      • ValueFormat
      • ValueFormatCategory
      • ValueFormatter
      • ValueFormatterIndex
      • ValueLinkConfig
      • ValueMappingFieldConfigSettings
      • valueMappingsOverrideProcessor
      • ValueMatcher
      • ValueMatcherID
      • ValueMatcherInfo
      • ValueMatcherOptions
      • valueMatchers
      • VAR_CALC
      • VAR_CELL_PREFIX
      • VAR_FIELD_LABELS
      • VAR_FIELD_NAME
      • VAR_SERIES_NAME
      • VariableModel
      • VariableOrigin
      • VariableSuggestion
      • VariableSuggestionsScope
      • VariableType
      • Vector
      • vectorator
      • VizOrientation
      • WithAccessControlMetadata
      • YAxis
    • @grafana/e2e
      • e2e
    • @grafana/e2e-selectors
    • @grafana/runtime
      • AngularComponent
      • AngularLoader
      • AzureSettings
      • BackendSrv
      • BackendSrvRequest
      • config
      • CopyPanelEvent
      • DashboardInfo
      • DashboardViewEventPayload
      • DataRequestEventPayload
      • DataRequestInfo
      • DataSourceSrv
      • DataSourceWithBackend
      • EchoBackend
      • EchoEvent
      • EchoEventType
      • EchoMeta
      • EchoSrv
      • ExperimentViewEchoEvent
      • ExperimentViewEchoEventPayload
      • featureEnabled
      • FetchError
      • FetchErrorDataProps
      • FetchResponse
      • frameToMetricFindValue
      • getAngularLoader
      • getAppEvents
      • getBackendSrv
      • GetDataSourceListFilters
      • getDataSourceSrv
      • getEchoSrv
      • getLegacyAngularInjector
      • getLocationSrv
      • getTemplateSrv
      • GrafanaBootConfig
      • HealthCheckResult
      • HealthCheckResultDetails
      • HealthStatus
      • InteractionEchoEvent
      • InteractionEchoEventPayload
      • isExperimentViewEvent
      • isInteractionEvent
      • isPageviewEvent
      • loadPluginCss
      • locationSearchToObject
      • locationService
      • LocationSrv
      • LocationUpdate
      • logDebug
      • logError
      • logInfo
      • logWarning
      • MetaAnalyticsEvent
      • MetaAnalyticsEventName
      • MetaAnalyticsEventPayload
      • PageviewEchoEvent
      • PageviewEchoEventPayload
      • PluginCssOptions
      • RefreshEvent
      • registerEchoBackend
      • reportExperimentView
      • reportInteraction
      • reportMetaAnalytics
      • reportPageview
      • SizeMeta
      • StreamOptionsProvider
      • TemplateSrv
      • ThemeChangedEvent
      • TimeRangeUpdatedEvent
      • toDataQueryError
      • toDataQueryResponse
    • @grafana/schema
      • AxisConfig
      • AxisPlacement
      • BarAlignment
      • BarConfig
      • BarGaugeDisplayMode
      • BigValueColorMode
      • BigValueGraphMode
      • BigValueJustifyMode
      • BigValueTextMode
      • defaultTableFieldOptions
      • FieldTextAlignment
      • FillConfig
      • GraphDrawStyle
      • GraphFieldConfig
      • GraphGradientMode
      • GraphThresholdsStyleConfig
      • GraphTransform
      • GraphTresholdsStyleMode
      • HideableFieldConfig
      • HideSeriesConfig
      • LegendDisplayMode
      • LegendPlacement
      • LineConfig
      • LineInterpolation
      • LineStyle
      • OptionsWithLegend
      • OptionsWithTextFormatting
      • OptionsWithTooltip
      • PointsConfig
      • ReduceDataOptions
      • ScaleDirection
      • ScaleDistribution
      • ScaleDistributionConfig
      • ScaleOrientation
      • SingleStatBaseOptions
      • SortOrder
      • StackableFieldConfig
      • StackingConfig
      • StackingMode
      • TableCellDisplayMode
      • TableFieldOptions
      • TableSortByFieldState
      • TooltipDisplayMode
      • VisibilityMode
      • VizLegendOptions
      • VizOrientation
      • VizTextDisplayOptions
      • VizTooltipOptions
    • @grafana/ui
      • ActionMeta
      • addStackingConfig
      • addTextSizeOptions
      • addTooltipOptions
      • Alert
      • AlertingSettings
      • AlertVariant
      • AsyncMultiSelect
      • AsyncSelect
      • AsyncSelectProps
      • Badge
      • BadgeColor
      • BadgeProps
      • BarGauge
      • BarGaugeDisplayMode
      • BigValue
      • BigValueColorMode
      • BigValueGraphMode
      • BigValueJustifyMode
      • BigValueTextMode
      • BracesPlugin
      • buildScaleKey
      • Button
      • ButtonCascader
      • ButtonGroup
      • ButtonProps
      • ButtonRow
      • ButtonSelect
      • ButtonVariant
      • calculateFontSize
      • CallToActionCard
      • Card
      • cardChrome
      • CardContainer
      • CardContainerProps
      • CardProps
      • Cascader
      • CascaderOption
      • CertificationKey
      • Checkbox
      • ClearPlugin
      • ClickOutsideWrapper
      • ClipboardButton
      • ClipboardPlugin
      • CodeEditor
      • CodeEditorMonacoOptions
      • CollapsableSection
      • Collapse
      • ColorPicker
      • colors
      • commonOptionsBuilder
      • CompletionItem
      • CompletionItemGroup
      • CompletionItemKind
      • ConfirmButton
      • ConfirmModal
      • ConfirmModalProps
      • Container
      • ContextMenu
      • ContextMenuProps
      • ControlComponent
      • ControlledCollapse
      • convertOldAngularValueMapping
      • Counter
      • CustomControlProps
      • CustomScrollbar
      • DataLinkInput
      • DataLinksContextMenu
      • DataLinksInlineEditor
      • DataSourceHttpSettings
      • DatePicker
      • DatePickerProps
      • DatePickerWithInput
      • DatePickerWithInputProps
      • DateTimePicker
      • defaultIntervals
      • DeleteButton
      • displayName
      • displayName
      • DOMUtil
      • Drawer
      • DropdownIndicator
      • DropzoneFile
      • EmotionPerfTest
      • EmptySearchResult
      • ErrorBoundary
      • ErrorBoundaryAlert
      • ErrorBoundaryAlertProps
      • ErrorWithStack
      • EventsCanvas
      • EventsWithValidation
      • FadeTransition
      • FeatureBadge
      • FeatureInfoBox
      • Field
      • FieldArray
      • FieldArrayApi
      • fieldMatchersUI
      • FieldSet
      • FieldValidationMessage
      • FileDropzone
      • FileDropzoneDefaultChildren
      • FileDropzoneProps
      • FileListItem
      • FileListItemProps
      • FileUpload
      • FilterInput
      • FilterPill
      • focusCss
      • Form
      • FormAPI
      • FormatOptionLabelMeta
      • FormattedValueDisplay
      • FormInputSize
      • FullWidthButtonContainer
      • Gauge
      • getAvailableIcons
      • getCardStyles
      • getChildId
      • getFieldTypeIcon
      • getFocusStyles
      • getInputStyles
      • getLogRowStyles
      • getMouseFocusStyles
      • getNextCharacter
      • getPreviousCousin
      • getScrollbarWidth
      • getSelectStyles
      • getStandardFieldConfigs
      • getTagColor
      • getTagColorsFromName
      • getTextColorForBackground
      • getTheme
      • getTooltipContainerStyles
      • Graph
      • GraphNG
      • GraphNGProps
      • GraphSeriesToggler
      • GraphSeriesTogglerAPI
      • graphTickFormatter
      • graphTimeFormat
      • GraphWithLegend
      • hasValidationEvent
      • HorizontalGroup
      • hoverColor
      • Icon
      • IconButton
      • IconButtonVariant
      • IconName
      • IconSize
      • IconType
      • IndentationPlugin
      • InfoBox
      • InlineField
      • InlineFieldRow
      • InlineFormLabel
      • InlineLabel
      • InlineSegmentGroup
      • InlineSwitch
      • Input
      • InputActionMeta
      • InputControl
      • JsonExplorer
      • JSONFormatter
      • Label
      • LegacyForms
      • LegacyInputStatus
      • Legend
      • LinkButton
      • linkModelToContextMenuItems
      • List
      • listItem
      • listItemSelected
      • LoadingPlaceholder
      • LoadingPlaceholderProps
      • LoadOptionsCallback
      • LogLabels
      • LogMessageAnsi
      • LogRows
      • makeFragment
      • makeValue
      • Marker
      • measureText
      • mediaUp
      • mockTheme
      • mockThemeContext
      • Modal
      • ModalRoot
      • ModalsContext
      • ModalsController
      • ModalsProvider
      • ModalTabsHeader
      • Monaco
      • MonacoEditor
      • MultiSelect
      • MultiSelectCommonProps
      • NewlinePlugin
      • NodeGraphDataFrameFieldNames
      • NumberValueEditor
      • OnTagClick
      • Pagination
      • PanelContainer
      • PanelContextRoot
      • PlotLegend
      • PlotSelection
      • PluginSignatureBadge
      • PluginSignatureBadgeProps
      • Popover
      • PopoverContent
      • PopoverController
      • Portal
      • preparePlotFrame
      • QueryField
      • RadioButtonGroup
      • RadioButtonList
      • RangeSlider
      • ReactUtils
      • RefreshPicker
      • regexValidation
      • Renderable
      • RenderFunction
      • renderOrCallToRender
      • resetSelectStyles
      • RunnerPlugin
      • SCHEMA
      • ScrollbarPosition
      • Segment
      • SegmentAsync
      • SegmentInput
      • Select
      • SelectableOptGroup
      • SelectAsyncProps
      • SelectBaseProps
      • SelectCommonProps
      • SelectContainer
      • SelectContainerProps
      • SelectionShortcutsPlugin
      • SelectOptions
      • SelectValue
      • SelectValueEditor
      • SeriesColorPicker
      • SeriesColorPickerPopover
      • SeriesColorPickerPopoverWithTheme
      • SeriesIcon
      • SeriesTable
      • SeriesTableProps
      • SeriesTableRow
      • SeriesTableRowProps
      • SeriesVisibilityChangeBehavior
      • SetInterval
      • sharedInputStyle
      • sharedSingleStatMigrationHandler
      • sharedSingleStatPanelChangedHandler
      • SingleStatBaseOptions
      • SlatePrism
      • SlideOutTransition
      • Slider
      • SliderValueEditor
      • sortedColors
      • Spinner
      • StackingEditor
      • StatsPicker
      • StringArrayEditor
      • StringValueEditor
      • styleMixins
      • stylesFactory
      • SuggestionsPlugin
      • SuggestionsState
      • Switch
      • Tab
      • TabbedContainer
      • TabConfig
      • TabContent
      • Table
      • TableInputCSV
      • TableSortByFieldState
      • TabsBar
      • Tag
      • TagList
      • TagsInput
      • TextArea
      • Themeable
      • Themeable2
      • ThemeContext
      • TimeOfDayPicker
      • TimeRangeInput
      • TimeRangePicker
      • TimeRangePickerProps
      • TimeSeries
      • TimeZonePicker
      • TLSAuthSettings
      • Token
      • ToolbarButton
      • ToolbarButtonRow
      • Tooltip
      • TypeaheadInput
      • TypeaheadOutput
      • UnitPicker
      • UPLOT_AXIS_FONT_SIZE
      • UPlotConfigBuilder
      • useStyles
      • useStyles2
      • useTheme
      • useTheme2
      • validate
      • ValidationEvents
      • ValidationRule
      • ValuePicker
      • VerticalGroup
      • VizLayout
      • VizLayoutComponentType
      • VizLayoutLegendProps
      • VizLayoutProps
      • VizLegend
      • VizLegendItem
      • VizRepeater
      • VizRepeaterRenderValueProps
      • VizTooltip
      • VizTooltipContainer
      • WeekStartPicker
      • WithContextMenu
      • withErrorBoundary
      • withTheme
      • XYCanvas
  • 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 Panelsbreadcrumb arrow Query a data source
Enterprise Open source RSS

Query a data source

Data source queries return data that appear in visualizations. The query language in which you write depends on the data source you query. Grafana supports connections with many types of data sources.

  • About queries
  • Navigate the query tab
  • Add a query
  • Use expressions to manipulate data
  • Manage queries
  • Share query results with another panel
  • Download raw query results
  • Inspect query performance
  • Inspect query request and response data

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.