# Visualizations available in Grafana version 9 **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). Grafana offers a variety of visualizations to support different use cases. This section of the documentation highlights the built-in panels, their options and typical usage. A common panel to get started with, and to learn the basics of using panels, is the [Time series panel](v9-panels-time-series.md) panel. **Topics** + [Alert list panel](v9-panels-alert-list.md) + [Annotations panel](v9-panels-annotations.md) + [Bar chart panel](v9-panels-bar-chart.md) + [Bar gauge](v9-panels-bar-gauge.md) + [Candlestick panel](v9-panels-candlestick.md) + [Canvas panel](v9-panels-canvas.md) + [Clock panel](v9-panels-clock.md) + [Dashboard list](v9-panels-dashboard-list.md) + [Gauge panel](v9-panels-gauge.md) + [Geomap panel](v9-panels-geomap.md) + [Graph panel](v9-panels-graph.md) + [Heatmap panel](v9-panels-heatmap.md) + [Histogram panel](v9-panels-histogram.md) + [Logs panel](v9-panels-logs.md) + [News panel](v9-panels-news.md) + [Node graph panel](v9-panels-node-graph.md) + [Pie chart panel](v9-panels-piechart.md) + [Plotly panel](v9-panels-plotly.md) + [Sankey panel](v9-panels-sankey.md) + [Scatter panel](v9-panels-scatter.md) + [Stat panel](v9-panels-stat.md) + [State timeline panel](v9-panels-state-timeline.md) + [Status history panel](v9-panels-status-history.md) + [Table panel](v9-panels-table.md) + [Text panel](v9-panels-text.md) + [Time series panel](v9-panels-time-series.md) + [Traces panel (Beta)](v9-panels-traces.md) + [WindRose](v9-panels-windrose.md) # Alert list panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The alert list panel displays your dashboards alerts. You can configure the list to show current state or recent state changes. For more information about alerts, see [Alerts in Grafana version 9](v9-alerts.md). Use these settings to refine your visualization. ## Options + **Group mode** – Choose **Default grouping** to show alert instances grouped by their alert rule, or **Custom grouping** to group alert instances by a custom set of labels. + **Max Items** – Set the maximum number of alerts to list. + **Sort order** – Select how to order the alerts displayed. + **Alphabetical (asc)** – Alphabetical order + **Alphabetical (desc)** – Reverse alphabetical order + **Importance** – By importance according to the following values, with 1 being the highest: + `alerting` or `firing`: 1 + `no_data`: 2 + `pending`: 3 + `ok`: 4 + `paused` or `inactive`: 5 + **Alerts from this dashboard** – Show alerts only from the dashboard that the alert list is in. ## Filter Use the following options to filter the alerts to match the query, folder, or tags that you choose: + **Alert name** – Enter an alert name query. + **Alert instance label** – Filter alert instances using label querying. For example, `{severity="critical", instance=~"cluster-us-.+"}`. + **Folder** – Select a folder. Only alerts from dashboards in the selected folder will be displayed. + **Datasource** – Filter alerts from the selected data source. ## State filter Choose which alert states to display in this panel. + Alerting / Firing + Pending + No data + Normal + Error # Annotations panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Annotations panel shows a list of available annotations you can use to view annotated data. Various options are available to filter the list based on tags and on the current dashboard. ## Annotation query The following options control the source query for the list of annotations. **Query Filter** Use the query filter to create a list of annotations from all dashboards in your organization or the current dashboard in which this panel is located. It has the following options: + All dashboards - List annotations from all dashboards in the current organization. + This dashboard - Limit the list to the annotations on the current dashboard. **Time Range** Use the time range option to specify whether the list should be limited to the current time range. It has the following options: + None - no time range limit for the annotations query. + This dashboard - Limit the list to the time range of the dashboard where the annotation list panel is available. **Tags** Use the tags option to filter the annotations by tags. You can add multiple tags in order to refine the list. **Note** Optionally, leave the tag list empty and filter on the fly by selecting tags that are listed as part of the results on the panel itself. *Limit* Use the limit option to limit the number of results returned. ## Display These options control additional metadata included in the annotations panel display. **Show user** Use this option to show or hide which user created the annotation. **Show time** Use this option to show or hide the time the annotation creation time. **Show Tags** Use this option to show or hide the tags associated with an annotation. *NB*: You can use the tags to live-filter the annotation list on the panel itself. ## Link behavior **Link target** Use this option to chose how to view the annotated data. It has the following options. + Panel - This option will take you directly to a full-screen view of the panel with the corresponding annotation + Dashboard - This option will focus the annotation in the context of a complete dashboard **Time before** Use this option to set the time range before the annotation. Use duration string values like “1h” = 1 hour, “10m” = 10 minutes, etc. **Time after** Use this option to set the time range after the annotation. # Bar chart panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). This panel visualization allows you to graph categorical data. ## Supported data formats Only one data frame is supported and it needs to have at least one string field that will be used as the category for an X or Y axis and one or more numerical fields. The following is an example of data formats: | Browser | Market share | | --- | --- | | Chrome | 50 | | Internet Explorer | 17.5 | If you have more than one numerical field, the panel shows grouped bars. ### Visualizing time series or multiple result sets If you have multiple time series or tables, you first need to join them using a join, or reduce transform. For example, if you have multiple time series and you want to compare their last and max value, add the **Reduce** transform and specify **Max** and **Last **as options under **Calculations**. ## Bar chart options Use these options to refine your visualizations: **Orientation** + **Auto ** – Grafana decides the bar orientation based on the panel dimensions. + **Horizontal** – Makes the X axis the category axis. + **Vertical** – Makes the Y axis the category axis. **X-axis tick label maximum length** sets the maximum length of bar chart labels. Labels longer than the maximum length are truncated (with ellipses). **Bar labels minimum spacing** sets the minimum spacing between bar labels. **Show values** Controls whether values are shown on top of or to the left of bars. + **Auto ** – Values are shown if there is space. + **Always** – Always show values. + **Never** – Never show values. **Stacking** Controls bar chart stacking. + **Off** – Bars will not be stacked. + **Normal** – Bars will be stacked on top of each other. + **Percent** – Bars will be stacked on top of each other, and the height of each bar is the percentage of the total height of the stack (all bar stacks will be the same height, adding up to 100 percent). **Group width** controls the width of groups. 0=min and 1=max width. **Bar width** controls the width of bars. 0=min and 1=max width. **Bar radius** controls the radius of the bars, 0 = minimum and 0.5 = maximum radius. **Highlight full area on hover** controls if the surrounding area of the bar is highlighted when you hover over the bar with a pointer. **Line width** controls line width of the bars. **Fill opacity** controls the fill opacity of the bars. **Gradient mode** sets the mode of the gradient fill. Fill gradient is based on the line color. To change the color, use the standard color scheme field option. Gradient appearance is influenced by the **Fill opacity** setting. + **None ** – no gradient fill, this is the default setting. + **Opacity** – Transparency of the gradient is calculated based on the values on the y-axis. Opacity of the fill is increasing with the values on the Y-axis. + **Hue** – Gradient color is generated based on the hue of the line color. **Tooltip mode** – When you hover your cursor over the visualization, Grafana can display tooltips. Choose how tooltips behave. + **Single ** – The hover tooltip shows only a single series, the one that you are hovering over on the visualization. + **All** – The hover tooltip shows all series in the visualization. Grafana highlights the series that you are hovering over in bold in the series list in the tooltip. + **Hidden** – Do not display the tooltip when you interact with the visualization. **Note** You can use an override to hide individual series from the tooltip. **Legend mode** – Use these settings to refine how the legend appears in your visualization. For more information, see [Configure a legend](v9-panels-configure-legend.md). + **List ** – Displays the legend as a list. This is a default display mode of the legend. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** – Choose where to place the legend. + **Bottom ** – Below the graph. + **Right** – To the right of the graph. **Legend calculations** – Choose which of the standard calculations to show in the legend. You can have more than one. **Text size** – Enter a value to change the size of the text on your bar chart. **Axis** – Use the following field settings to refine how your axes display. Some field options will not affect the visualization until you click outside of the field option box you are editing or press Enter. + **Placement ** – Sets the placement of the Y-axis. + **Auto** – Grafana automatically assigns Y-axis to the series. When there are two or more series with different units, then Grafana assigns the left axis to the first unit and right to the following units. + **Left** – Display all Y-axes on the left side. + **Right** – Display all Y-axes on the right side. + **Hidden** – Hide all Y-axes. + **Label** – Set a Y-axis text label. If you have more than one Y-axis, then you can assign different labels with an override. + **Width** – Set a fixed width of the axis. By default, Grafana dynamically calculates the width of an axis. By setting the width of the axis, data with different axes types can share the same display proportions. This makes it easier to compare more than one graph’s worth of data because the axes are not shifted or stretched within visual proximity of each other. + **Soft min and soft max** – Set a soft min and soft max option for better control of Y-axis limits. By default, Grafana sets the range for the Y-axis automatically based on the dataset. Soft min and soft max settings can prevent blips from turning into mountains when the data is mostly flat, and hard min or max derived from standard min and max field options can prevent intermittent spikes from flattening useful detail by clipping the spikes past a defined point. You can set standard min/max options to define hard limits of the Y-axis. # Bar gauge **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The bar gauge simplifies your data by reducing every field to a single value. You choose how Grafana calculates the reduction. This panel can show one or more bar gauges depending on how many series, rows, or columns your query returns. ## Value options Use the following options to refine how your visualization displays the value: **Show** – Choose how Grafana displays your data. **Calculate** – Show a calculated value based on all rows. + **Calculation** – Select a reducer function that Grafana will use to reduce many fields to a single value. For a list of available calculations, refer to Calculation types. + **Fields** – Select the fields display in the panel. **All values** – Show a separate stat for every row. If you select this option, then you can also limit the number of rows to display. + **Limit** – The maximum number of rows to display. Default is 5,000. + **Fields** – Select the fields display in the panel. ## Bar gauge options Adjust how the bar gauge is displayed. **Orientation** – Choose a stacking direction. + **Auto** – Grafana selects what it thinks is the best orientation. + **Horizontal** – Bars stretch horizontally, left to right. + **Vertical** – Bars stretch vertically, bottom to top. **Display mode** – Choose a display mode. + **Gradient** – Threshold levels define a gradient. + **Retro LCD** – The gauge is split into small cells that are lit or unlit. + **Basic** – Single color based on the matching threshold. **Show unfilled area** – Select this if you want to render the unfilled region of the bars as dark gray. Not applicable to Retro LCD display mode. **Min width** Limit the minimum width of the bar column in the vertical direction. Automatically show x-axis scrollbar when there is a large amount of data. **Min height** Limit the minimum height of the bar row in the horizontal direction. Automatically show y-axis scrollbar when there is a large amount of data. # Candlestick panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Candlestick panel allows you to visualize data that includes a number of consistent dimensions focused on price movement. The Candlestick panel includes an Open-High-Low-Close (OHLC) mode, as well as support for additional dimensions based on time series data. The Candlestick panel builds upon the foundation of the [Time series panel](v9-panels-time-series.md) and includes many common configuration settings. **Mode** The mode options allow you to toggle which dimensions are used for the visualization. + **Candles** limits the panel dimensions to the open, high, low, and close dimensions used by candlestick visualizations. + **Volume** limits the panel dimension to the volume dimension. + **Both** is the default behavior for the candlestick panel. It includes both candlestick and volume visualizations. **Candle style** + **Candles** is the default display style and creates candle-style visualizations between the open and close dimensions. + **OHLC Bars** displays the four core dimensions open, high, low, and close values. **Color strategy** + **Since Open** is the default behavior. This mode will utilize the *Up* color (below) if the intra-period price movement is positive. In other words, if the value on close is greater or equal to the value on open, the *Up* color is used. + **Since Prior Close** is an alternative display method where the color of the candle is based on the interperiod price movement or change in value. In other words, if the value on open is greater than the previous value on close, the *Up* color is used. If the value on open is lower than the previous value on close, the *Down* color is used. *This option also triggers the hollow candlestick visualization mode*. Hollow candlesticks indicate that the intra-period movement is positive (value is higher on close than on open), filled candlesticks indicate the intra-period change is negative (value is lower on close than on open). To learn more, see the [explanation of the differences](https://thetradingbible.com/how-to-read-hollow-candlesticks). **Up & Down Colors** The **Up color** and **Down color** options select which colors are used when the price movement is up or down. The *Color strategy* above will determine if intra-period or inter-period price movement is used to select the candle or OHLC bar color. **Open, High, Low, Close** The candlestick panel will attempt to map fields to the appropriate dimension. The **Open**, **High**, **Low**, and **Close** options allow you to map your data to these dimensions if the panel is unable to do so. **Note** These values are hidden from the legend. + **Open** corresponds to the starting value of the given period. + **High** corresponds to the highest value of the given period. + **Low** corresponds to the lowest value of the given period. + **Close** corresponds to the final (end) value of the given period. + **Volume** corresponds to the sample count in the given period. (e.g. number of trades) **Additional fields** The candlestick panel is based on the time series panel. It can visualize additional data dimensions beyond open, high, low, close, and volume The **Include** and **Ignore** options allow the panel to visualize other included data such as simple moving averages, Bollinger bands and more, using the same styles and configurations available in the [Time series panel](v9-panels-time-series.md). # Canvas panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). Canvas is a new panel that combines the power of Grafana with the flexibility of custom elements. Canvas visualizations are extensible form-built panels that allow you to explicitly place elements within static and dynamic layouts. This empowers you to design custom visualizations and overlay data in ways that aren’t possible with standard Grafana panels, all within Grafana’s UI. If you’ve used popular UI and web design tools, then designing Canvas panels will feel very familiar. ## Elements **Metric value** The metric value element enables you to easily select the data you want to display on canvas. This element has a unique “edit” mode that can be triggered either through the context menu “Edit” option or by double-clicking. When in edit mode you can select which field data that you want to display. **Text** The text element enables you to easily add text to the canvas. The element also supports an editing mode, triggered via either double-clicking or the edit menu option in the context menu. **Rectangle** The rectangle element enables you to add a basic rectangle to the canvas. Rectangle elements support displaying text (both fixed and field data) as well as can change background color based on data thresholds. **Icon** The icon element enables you to add a supported icon to the canvas. Icons can have their color set based on thresholds or value mappings. ## Canvas Editing **Inline editor** Canvas introduces a new editing experience. You can now edit your canvas panel inline while in the context of dashboard mode. **Context menu** The context menu gives you access to common tasks. Supported functionality includes opening and closing the inline editor, duplicating an element, deleting an element, and more. The context menu is triggered by a right click action over the panel or a given canvas element. When right clicking the panel, you are able to set a background image and easily add elements to the canvas. When right clicking an element, you are able to edit, delete, and duplicate the element, or modify the element’s layer positioning. ## Canvas Options **Inline editing** The inline editing toggle enables you to lock or unlock the canvas panel. When turned off the canvas panel becomes *locked*, freezing elements in place and preventing unintended modifications. # Clock panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The clock panel shows the current time or a countdown. It updates every second. + **Mode** – The default is **time**. If you choose **countdown**, set the **Countdown Deadline** to start the countdown. + **12 or 24 hour** – The options for showing the time are 12-hour format and 24-hour format. + **Timezone** – The time zones are supplied by the moment timezone library. The default is the time zone on your computer. + **Countdown Deadline** – Specify the time and date to count down to, if you have set **Mode** to **countdown**. + **Countdown End Text** – Specify the text to show when the countdown ends. + **Date/Time formatting options** – Customize the font size, weight, and date/time formatting. If you are showing a countdown and don't want to see the seconds ticking down, change the time format to `hh:mm` for the 24-hour clock or `h:mm A` for the 12-hour clock. For a complete list of options, see [ Display](https://momentjs.com/docs/#/displaying/). + **Bg Color** – Select a background color for the clock. # Dashboard list **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The dashboard list visualization allows you to display dynamic links to other dashboards. The list can be configured to use starred dashboards, recently viewed dashboards, a search query, and dashboard tags. On each dashboard load, this panel queries the dashboard list, always providing the most up-to-date results. **Options** Use these options to refine your visualization. + **Starred** – Display starred dashboards in alphabetical order. + **Recently viewed** – Display recently viewed dashboards in alphabetical order. + **Search** – Display dashboards by search query or tags. You must enter at least one value in **Query** or **Tags**. For the **Query** and **Tags** fields, variable interpolation is supported, for example, `$my_var` or `${my_var}`. + **Show headings** – The chosen list selection (Starred, Recently viewed, Search) is shown as a heading. + **Max items** – Sets the maximum number of items to list per section. For example, if you left this at the default value of 10 and displayed Starred and Recently viewed dashboards, then the panel would display up to 20 total dashboards, ten in each section. **Search** These options only apply if the **Search** option is selected. + **Query** – Enter the query you want to search by. Queries are case-insensitive, and partial values are accepted. + **Folder** – Select the dashboard folders that you want to display. + **Tags** – Here is where you enter your tags you want to search by. Existing tags will not appear as you type, and they *are* case sensitive. **Note** When multiple tags and strings appear, the dashboard list displays those matching *all* conditions. # Gauge panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). Gauge is a single-value visualization that can repeat a gauge for every series, column or row. **Value options** Use the following options to refine how your visualization displays the value: **Show** Choose how Grafana displays your data. **Calculate** Show a calculated value based on all rows. + **Calculation** – Select a reducer function that Grafana will use to reduce many fields to a single value. For a list of available calculations, refer to [Calculation types](v9-panels-calculation-types.md). + **Fields** – Select the fields to display in the panel. **All values** Show a separate stat for every row. If you select this option, then you can also limit the number of rows to display. + **Limit** – The maximum number of rows to display. Default is 5,000. + **Fields** – Select the fields to display in the panel. **Gauge** Adjust how the gauge is displayed. + **Show threshold labels** – Controls if threshold values are shown. + **Show threshold markers** – Controls if a threshold band is shown outside the inner gauge value band. **Text size** Adjust the sizes of the gauge text. + **Title** – Enter a numeric value for the gauge title size. + **Value** – Enter a numeric value for the gauge value size. # Geomap panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Geomap panel visualization allows you to view and customize the world map using geospatial data. You can configure various overlay styles and map view settings to easily focus on the important location-based characteristics of the data. ## Map View The map view controls the initial view of the map when the dashboard loads. **Initial View** The initial view configures how the GeoMap panel renders when the panel is first loaded. + **View** sets the center for the map when the panel first loads. + **Fit to data** fits the map view based on the data extents of Map layers and updates when data changes. + **Data** option allows selection of extent based on data from “All layers”, a single “Layer”, or the “Last value” from a selected layer. + **Layer** can be selected if fitting data from a single “Layer” or the “Last value” of a layer. + **Padding** sets padding in relative percent beyond data extent (not available when looking at “Last value” only). + **Max Zoom** sets the maximum zoom level when fitting data. + **Coordinates** sets the map view based on: + **Latitude** + **Longitude** + Default Views are also available including: + **(0°, 0°)** + **North America** + **South America** + **Europe** + **Africa** + **West Asia** + **South Asia** + **South-East Asia** + **East Asia** + **Australia** + **Oceania** + **Zoom** sets the initial zoom level. ## Map layers The Geomap visualization supports showing multiple layers. Each layer determines how you visualize geospatial data on top of the base map. **Types** There are three map layer types to choose from in the Geomap visualization. + [Markers layer](#v9-panels-geomap-markers) renders a marker at each data point. + [Heatmap layer](#v9-panels-geomap-heatmap) visualizes a heatmap of the data. + [GeoJSON layer](#v9-panels-geomap-geojson) renders static data from a GeoJSON file. There are also five layer types that are currently in alpha. + [Night / Day layer (Alpha)](#v9-panels-geomap-nightday) renders a night or day region. + **Icon at last point (alpha)** renders an icon at the last data point. + **Dynamic GeoJSON (alpha)** styles a GeoJSON file based on query results. + **Route (alpha)** render data points as a route. + [Photos layer (Alpha)](#v9-panels-geomap-photos) renders a photo at each data point. **Layer Controls** The layer controls allow you to create layers, change their name, reorder and delete layers. + **Add layer** creates an additional, configurable data layer for the Geomap visualization. When you add a layer, you are prompted to select a layer type. You can change the layer type at any point during panel configuration. See the **Layer Types** section above for details on each layer type. + The layer controls allow you to rename, delete, and reorder the layers of the panel. + **Edit layer name** (pencil icon) renames the layer. + **Trash Bin** deletes the layer. + **Reorder** (six dots/grab handle) allows you to change the layer order. Data on higher layers will appear above data on lower layers. The panel will update the layer order as you drag and drop to help simplify choosing a layer order. You can add multiple layers of data to a single Geomap panel in order to create rich, detailed visualizations. **Location** The Geomap panel needs a source of geographical data. This data comes from a database query, and there are four mapping options for your data. + **Auto** automatically searches for location data. Use this option when your query is based on one of the following names for data fields. + geohash: “geohash” + latitude: “latitude”, “lat” + longitude: “longitude”, “lng”, “lon” + lookup: “lookup” + **Coords** specifies that your query holds coordinate data. You will get prompted to select numeric data fields for latitude and longitude from your database query. + **Geohash** specifies that your query holds geohash data. You will be prompted to select a string data field for the geohash from your database query. + **Lookup** specifies that your query holds location name data that needs to be mapped to a value. You will be prompted to select the lookup field from your database query and a gazetteer. The gazetteer is the directory that is used to map your queried data to a geographical point. ## Markers layer The markers layer allows you to display data points as different marker shapes such as circles, squares, triangles, stars, and more. Markers have many customization options. + **Marker Color** configures the color of the marker. The default `Single color` keeps all points a single color. There is an alternate option to have multiple colors depending on the data point values and the threshold set at the `Thresholds` section. + **Marker Size** configures the size of the marker. The default is `Fixed size`, which makes all marker sizes the same regardless of the data points. However, there is also an option to scale the circles to the corresponding data points. `Min` and `Max` marker size has to be set such that the Marker layer can scale within this range. + **Marker Shape** allows you to choose the shape, icon, or graphic to aid in providing additional visual context to your data. Choose from assets that are included with Grafana such as simple shapes or the Unicon library. You can also specify a URL containing an image asset. The image must be a scalable vector graphic (SVG). + **Fill opacity** configures the transparency of each marker. ## Heatmap layer The heatmap layer clusters various data points to visualize locations with different densities. To add a heatmap layer: Click on the dropdown menu under Data Layer and choose `Heatmap`. Similar to `Markers`, you are prompted with options to determine which data points to visualize and how you want to visualize them. + **Weight values** configure the intensity of the heatmap clusters. `Fixed value` keeps a constant weight value throughout all data points. This value should be in the range of 0\$11. Similar to Markers, there is an alternate option in the dropdown to automatically scale the weight values depending on data values. + **Radius** configures the size of the heatmap clusters. + **Blur** configures the amount of blur on each cluster. ## GeoJSON layer The GeoJSON layer allows you to select and load a static GeoJSON file from the filesystem. + **GeoJSON URL** provides a choice of GeoJSON files that ship with Grafana. + **Default Style** controls which styles to apply when no rules above match. + **Color** configures the color of the default style + **Opacity** configures the default opacity + **Style Rules** apply styles based on feature properties + **Rule** allows you to select a *feature*, *condition*, and *value* from the GeoJSON file in order to define a rule. The trash bin icon can be used to delete the current rule. + **Color** configures the color of the style for the current rule + **Opacity** configures the transparency level for the current rule + **Add style rule** creates additional style rules. ## CARTO layer A CARTO layer is from [CARTO](https://carto.com/about-us/) Raster basemaps. **Options** + **Theme** Choose a theme, either a **Light** theme, **Dark** theme, or **Auto** theme. + **Show labels** shows the Country details on top of the map. + **Opacity** from 0 (transparent) to 1 (opaque) ## XYZ tile layer The XYZ tile layer is a map from a generic tile layer. **Note** For more information about generic tile layers, see [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map), and [List of Open Street Map Tile Servers](https://wiki.openstreetmap.org/wiki/Tile_servers). **Options** + **URL template** **Note** Set a valid tile server url, with \$1z\$1/\$1x\$1/\$1y\$1 for example: `https://tile.openstreetmap.org/{z}/{x}/{y}.png`. + **Attribution** sets the reference string for the layer if displayed in [map controls](#v9-panels-geomap-controls) + **Opacity** from 0 (transparent) to 1 (opaque) ## Open Street Map layer A map from [Open Street Map](https://www.openstreetmap.org/about), a collaborative, free geographic world database. **Options** + **Opacity** from 0 (transparent) to 1 (opaque) ## ArcGIS layer An [ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) layer is a layer from an [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer. **Options** + **Server Instance** to select from the following map types. + World Street Map + World Imagery + World Physical + Topographic + USA Topographic + World Ocean + Custom MapServer (see [XYZ](#v9-panels-geomap-xyz) for formatting) + URL template + Attribution + **Opacity** from 0 (transparent) to 1 (opaque) ## Night / Day layer (Alpha) The Night / Day layer displays night and day regions based on the current time range. **Note** For more information, see[Extensions for OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html). **Options** + **Show** toggles time source from panel time range + **Night region color** picks color for night region + **Display sun** toggles sun icon + **Opacity** from 0 (transparent) to 1 (opaque) ## Photos layer (Alpha) The Photos layer renders a photo at each data point. **Note** For more information, see [Extensions for OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html). **Options** + **Image Source Field** Select a string field containing image data in either of the following formats: + **Image URLs** + **Base64 encoded** image binary (`data:image/png;base64,…`) + **Kind** select the frame style around the images + **Square** + **Circle** + **Anchored** + **Folio** + **Crop** toggle if the images are cropped to fit + **Shadow** toggle a box shadow behind the images + **Border** set the border size around images + **Border color** set the border color around images + **Radius** set the overall size of images in pixels ## Map Controls The map controls interface contains the following options for map information and tool overlays. **Zoom** This section describes each of the zoom controls. *Show zoom control* Displays zoom controls in the upper left corner. *Mouse wheel zoom* Turns on or off using the mouse wheel for zooming in or out. **Show attribution** Displays attribution for basemap layers on the map. **Show scale** Displays scale information in the bottom left corner. **Note** Displays units in [m]/[km]. **Show measure tools** Displays measure tools in the upper right corner. Measurements appear only when this control is open. + **Click** to start measuring + **Continue clicking** to continue measurement + **Double-click** to end measurement **Note** When you change measurement type or units, the previous measurement is removed from the map. If the control is closed and then re-opened, the most recent measurement is displayed. A measurement can be modified by clicking and dragging on it. *Length* Get the spherical length of a geometry. This length is the sum of the great circle distances between coordinates. For multi-part geometries, the length is the sum of the length of each part. Geometries are assumed to be in ‘EPSG:3857’. You can choose the following units for length measurements: + **Metric (m/km)** + **Feet (ft)** + **Miles (mi)** + **Nautical miles (nmi)** *Area* Get the spherical area of a geometry. This area is calculated assuming that polygon edges are segments of great circles on a sphere. Geometries are assumed to be in ‘EPSG:3857’. You can choose the following units for area measurements: + **Square Meters (m²)** + **Square Kilometers (km²)** + **Square Feet (ft²)** + **Square Miles (mi²)** + **Acres (acre)** + **Hectare (ha)** **Show debug** Displays debug information in the upper right corner of the map. This can be useful for debugging or validating a data source. + **Zoom** displays the current zoom level of the map. + **Center** displays the current **longitude**, and **latitude** of the map center. **Tooltip** + **None** displays tooltips only when a data point is clicked. + **Details** displays tooltips when a pointer hovers over a data point. # Graph panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). A graph panel can render as a line, a path of dots, or a series of bars. This type of graph is versatile enough to display almost any time-series data. ## Data and field options When using graph visualizations, you can apply the following options: + [Transform data](v9-panels-xform.md) + Alerts. This is the only type of visualization that allows you to set alerts. For more information, see [Alerts in Grafana version 9](v9-alerts.md). + [Configure thresholds](v9-panels-configure-thresholds.md) ## Display options To refine your visualization, use the following settings: + **Bars** – Display values as a bar chart. + **Lines** – Display values as a line graph. + **Line width** – Specify the width of the line for a series. The default is 1. + **Staircase** – Draw adjacent points as staircase. + **Area fill** – Specify the amount of color fill for a series. The default is 1; 0 is none. + **Fill gradient** – Specify the degree of gradient on the area fill. The default is 0, which is no gradient; 10 is a steep gradient. + **Points** – Display points for values. + **Point radius** – Control how large the points are. + **Alert thresholds** – Display alert thresholds and Regions on the panel. ### Stacking and null value + **Stack** – Each series is stacked on top of another. + **Percent** – Each series is drawn as a percentage of the total of all series. This option is available when **Stack** is selected. + **Null value** – Specify how null values are displayed. *This is an important setting.* See the note below. + **connected** – If there is a gap in the series, meaning one or more null values, the line will skip the gap and connect to the next non-null value. + **null** If there is a gap in the series, meaning a null value, the line in the graph will be broken and show the gap. This is the default setting. + **null as zero** – If there is a gap in the series, meaning a null value, it will be displayed as a zero value in the graph panel. **Important** If you are monitoring a server’s CPU load and the load reaches 100 percent, the server will lock up, and the agent sending statistics will not be able to collect the load statistic. This leads to a gap in the metrics, and using the default *null* setting means that Amazon Managed Grafana will show the gaps and indicate that something is wrong. If this is set to *connected*, it will be easy to miss this signal. ### Hover tooltip Use these settings to change the appearance of the tooltip that appears when you pause over the graph visualization. + **Mode** – Determines how many series the hover tooltip shows. + **All series** – The hover tooltip shows all series in the graph. In the series list in the tooltip, the Grafana workspace highlights the series that you are pausing on in bold. + **Single** – The hover tooltip shows only a single series, the one that you are pausing on in the graph. + **Sort order** – Sorts the order of series in the hover tooltip if you have selected **All series** mode. When you pause on a graph, Amazon Managed Grafana displays the values associated with the lines. Generally, users are most interested in the highest or lowest values. Sorting these values can make it much easier to find the data that you want. + **None** – The order of the series in the tooltip is determined by the sort order in your query. For example, you can sort the series alphabetically by series name. + **Increasing** – The series in the hover tooltip are sorted by value and in increasing order, with the lowest value at the top of the list. + **Decreasing** – The series in the hover tooltip are sorted by value and in decreasing order, with the highest value at the top of the list. ## Series overrides Series overrides allow a series in a graph panel to be rendered differently from the others. You can customize display options on a per-series basis or by using regex rules. For example, one series can have a thicker line width to make it stand out or be moved to the right Y-axis. You can add multiple series overrides. **To add a series override** 1. Choose **Add series override**. 1. In **Alias or regex**, type or select a series. Choose the field to see a list of available series. For example, `/Network.*/` would match two series named `Network out` and `Network in`. 1. Choose **\$1** and then select a style to apply to the series. You can add multiple styles to each entry. + **Bars** – Show series as a bar graph. + **Lines** – Show series as a line graph. + **Line fill** – Show a line graph with area fill. + **Fill gradient** – Specify the area fill gradient amount. + **Line width** – Set line width. + **Null point mode** – Use this option to ignore null values or replace them with zero. This is important if you want to ignore gaps in your data. + **Fill below to** – Fill the area between two series. + **Staircase line** – Show series as a staircase line. + **Dashes** – Show a line with dashes. + **Hidden Series** – Hide the series. + **Dash Length** – Set the length of dashes in the line. + **Dash Space** – Set the length of the spaces between the dashes in the line. + **Points** – Show series as separate points. + **Point Radius** – Set the radius for point rendering. + **Stack** – Set the stack group for the series. + **Color** – Set the series color. + **Y-axis** – Set the series y-axis. + **Z-index** – Set the series z-index (rendering order). This option is important when you are overlaying different styles, such as bar charts and area charts. + Transform – Transform value to negative to render below the y-axis. + **Legend** – Control whether a series is shown in the legend. + **Hide in tooltip** – Control whether a series is shown in a graph tooltip. ## Axes Use these options to control the display of axes in the visualization. ### Left Y/Right Y Options are identical for both y-axes. + **Show** – Choose to show or hide the axis. + **Unit** – Choose the display unit for the y value. + **Scale** – Choose the scale to use for the y value: **linear**, or **logarithmic**. The default is **linear**. + **Y-Min** – The minimum y value. The default is **auto**. + **Y-Max** – The maximum Y value. The default is **auto**. + **Decimals** – Define how many decimals are displayed for the y value. The default is **auto**. + **Label** – Specify the y axis label. The default is “", ### Y-Axes + **Align** – Align left and right y-axes by value. The default is unchecked/false. + **Level** – Enter the value to use for alignment of left and right y-axes, starting from Y=0. The default is 0. This option is available when **Align** is selected. ### X-Axis + **Show** – Choose to show or hide the axis. + **Mode** – The display mode completely changes the visualization of the graph panel. It’s like three panels in one. The main mode is the time series mode with time on the x-axis. The other two modes are a basic bar chart mode with series on the x-axis instead of time and a histogram mode. + **Time** (default) – The x-axis represents time and the data is grouped by time (for example, by hour, or by minute). + **Series** – The data is grouped by series, and not by time. The y-axis still represents the value. + **Value** – This is the aggregation type to use for the values. The default is **total** (summing the values together). + **Histogram** – This option converts the graph into a histogram. A histogram is a kind of bar chart that groups numbers into ranges, often called buckets or bins. Taller bars show that more data falls in that range. For more information about histograms, see [Introduction to histograms and heatmaps](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps). + **Buckets** – Sets the number of buckets to group the values by. If left empty, Amazon Managed Grafana tries to calculate a suitable number of buckets. + **X-Min** – Filters out values from the histogram that are less than this minimum limit. + **X-Max** – Filters out values that are greater than this maximum limit. ## Legend Use these settings to refine how the legend appears in your visualization. ### Options + **Show** – Clear to hide the legend. The default is selected (true). + **As Table** – Select to display the legend in the table. The default is checked (true). + **To the right** – Select to display the legend to the right. + Width – Enter the minimum width for the legend in pixels. This option is available when **To the right** is selected. ### Values Additional values can be shown alongside the legend names. + **Min** – The minimum value returned from the metric query. + **Max** – The maximum value returned from the metric query. + **Avg** – The average value returned from the metric query. + **Current** – The last value returned from the metric query. + **Total** – The sum of all values returned from the metric query. + **Decimals** – How many decimals are displayed for legend values and graph hover tooltips. Amazon Managed Grafana calculates the legend values on the client side. These legend values depend on the type of aggregation or point consolidation that your metric query is using. All the above legend values cannot be correct at the same time. For example, if you plot a rate such requests/second, which is probably using average as an aggregator, the Total in the legend will not represent the total number of requests. It is just the sum of all data points received by Amazon Managed Grafana. ### Hide series Hide series when all values of a series from a metric query are of a specific value. + **With only nulls** – Value=null (default unchecked) + **With only zeroes** – Value=zero (default unchecked) ### Time regions You can highlight specific time regions on the graph to make it easier to see, for example, weekends, business hours, and off-work hours. All configured time regions refer to UTC time. # Heatmap panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Heatmap panel visualization allows you to view histograms over time. For more information about histograms, refer to [Introduction to histograms and heatmaps](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps). ## Calculate from data This setting determines if the data is already a calculated heatmap (from the data source/transformer), or one that should be calculated in the panel. **X Bucket** This setting determines how the X-axis is split into buckets. You can specify a time interval in the **Size** input. For example, a time range of `1h` makes the cells 1-hour wide on the X-axis. **Y Bucket** This setting determines how the Y-axis is split into buckets. **Y Bucket scale** Select one of the following Y-axis value scales: + **linear** – Linear scale. + **log (base 2)** – Logarithmic scale with base 2. + **log (base 10)** – Logarithmic scale with base 10. ## Y Axes Defines how the Y axis is displayed **Placement** + **Left** – On the left + **Right** – On the right + **Hidden** – Hidden **Unit** Unit configuration **Decimals** This setting determines decimal configuration. **Min/Max value** This setting configures the axis range. **Reverse** When selected, the axis appears in reverse order. ## Colors The color spectrum controls the mapping between value count (in each bucket) and the color assigned to each bucket. The leftmost color on the spectrum represents the minimum count and the color on the right most side represents the maximum count. Some color schemes are automatically inverted when using the light theme. You can also change the color mode to Opacity. In this case, the color will not change but the amount of opacity will change with the bucket count + **Mode** + **Scheme** – Bucket value represented by cell color. + **Scheme** – If the mode is **scheme**, then select a color scheme. + **opacity** – Bucket value represented by cell opacity. Opaque cell means maximum value. + **Color** – Cell base color. + **Scale** – Scale for mapping bucket values to the opacity. + **linear** – Linear scale. Bucket value maps linearly to the opacity. + **sqrt** – Power scale. Cell opacity calculated as `value ^ k`, where `k` is a configured **Exponent** value. If exponent is less than `1`, you will get a logarithmic scale. If exponent is greater than `1`, you will get an exponential scale. In case of `1`, scale will be the same as linear. + **Exponent** – value of the exponent, greater than `0`. **Start/end color from value** By default, Grafana calculates cell colors based on minimum and maximum bucket values. With Min and Max you can overwrite those values. Consider a bucket value as a Z-axis and Min and Max as Z-Min and Z-Max, respectively. + **Start** – Minimum value using for cell color calculation. If the bucket value is less than Min, then it is mapped to the “minimum” color. The series min value is the default value. + **End** – Maximum value using for cell color calculation. If the bucket value is greater than Max, then it is mapped to the “maximum” color. The series max value is the default value. ## Cell display Use cell display settings to refine the visualization of the cells in your heatmap. ## Additional display options **Tooltip** + **Show tooltip** – Show heatmap tooltip. + **Show Histogram** – Show a Y-axis histogram on the tooltip. A histogram represents the distribution of the bucket values for a specific timestamp. **Legend** Choose whether you want to display the heatmap legend on the visualization. **Exemplars** Set the color used to show exemplar data. # Histogram panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The histogram visualization calculates the distribution of values and presents them as a bar chart. The Y-axis and the height of each bar represent the count of values that fall into each bracket while the X-axis represents the value range. Histogram visualization supports time series and any table results with one or more numerical fields. ## Supported formats Histogram visualization supports time series and any table results with one or more numerical fields. ## Display options Use these options to refine your visualizations: **Bucket size** The size of the buckets. Leave this empty for automatic bucket sizing (\$110% of the full range). **Bucket offset** If the first bucket should not start at zero. A non-zero offset shifts the aggregation window. For example, 5-sized buckets that are 0–5, 5–10, 10–15 with a default 0 offset would become 2–7, 7–12, 12–17 with an offset of 2; offsets of 0, 5, or 10, in this case, would effectively do nothing. Typically, this option would be used with an explicitly defined bucket size rather than automatic. For this setting to affect, the offset amount should be greater than 0 and less than the bucket size; values outside this range will have the same effect as values within this range. **Combine series** This will merge all series and fields into a combined histogram. **Line width** controls line width of the bars. **Fill opacity** controls the fill opacity of the bars. **Gradient mode** sets the mode of the gradient fill. Fill gradient is based on the line color. To change the color, use the standard color scheme field option. Gradient appearance is influenced by the Fill opacity setting. + **None ** – No gradient fill, this is the default setting. + **Opacity** – Transparency of the gradient is calculated based on the values on the Y-axis. Opacity of the fill is increasing with the values on the Y-axis. + **Hue** – Gradient color is generated based on the hue of the line color. **Tooltip mode** When you hover your cursor over the graph, Grafana can display tooltips. Choose how tooltips behave: + **Single** – The hover tooltip shows only the series that you are hovering over. + **All** – The hover tooltip shows all the series in the visualization. Grafana highlights the series that you are hovering over in bold in the series list in the tooltip. + **Hidden** – Do not display the tooltip. **Note** Use an override to hide individual series from the tooltip. ## Legend options When the legend option is enabled, it can show either the value mappings or the threshold brackets. To show the value mappings in the legend, it’s important that the Color scheme option under standard options is set to Single color or Classic palette. To see the threshold brackets in the legend, set the Color scheme to From thresholds. **Legend mode** Use these settings to refine how the legend appears in your visualization. + **List ** – Displays the legend as a list. This is a default display mode of the legend. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** Choose where to place the legend. + **Bottom ** – Below the graph. + **Right** – To the right of the graph. **Legend Values** Choose which of the standard calculations to show in the legend. You can have more than one. For more information, see [Calculation types](v9-panels-calculation-types.md). **Legend calculations** Choose which calculations to show in the legend. You can select more than one. # Logs panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The logs panel visualization shows log lines from data sources that support logs, such as Elastic, Influx, and Loki. Typically, you would use this panel next to a graph panel to display the log output of a related process. The logs panel shows the result of queries that were entered on the **Query** tab. The results of multiple queries are merged and sorted by time. You can scroll inside the panel if the data source returns more lines than can be displayed. To limit the number of lines rendered, you can use the **Max data points** setting in the **Query options**. If it is not set, the data source will usually enforce a default limit. ## Log level For logs where a **level** label is specified, we use the value of the label to determine the log level and update color accordingly. If the log doesn’t have a level label specified, we try to find out if its content matches any of the supported expressions (see below for more information). The log level is always determined by the first match. In case Grafana is not able to determine a log level, it will be visualized with **unknown** log level. For more information, see [Logs visualization](v9-explore-logs.md#v9-explore-logs-viz). ## Log details Each log row has an extendable area with its labels and detected fields, for more robust interaction. Each field or label has a stats icon to display statistics in relation to all displayed logs. **Data links** By using data links, you can turn any part of a log message into an internal or external link. The created link is visible as a button in the **Links** section inside the **Log details** view. **Display options** Use the following settings to refine your visualization: + **Time** – Show or hide the time column. This is the timestamp associated with the log line as reported from the data source. + **Unique labels** – Show or hide the unique labels column, which shows only non-common labels. + **Common labels** – Show or hide the common labels + **Wrap lines** – Toggle line wrapping. + **Prettify JSON** – Set this to `true` to pretty print all JSON logs. This setting does not affect logs in any format other than JSON. + **Enable log details** – Toggle option to see the log details view for each log row. The default setting is `true`. + **Order** – Display results in descending or ascending time order. The default is **Descending**, showing the newest logs first. Set to **Ascending** to show the oldest log lines first. # News panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). This panel displays an RSS feed. By default, it displays articles from the Grafana Labs blog. Enter the URL of an RSS in the **Display** section. This panel type does not accept any other queries. **Note** RSS feeds are loaded by the Grafana front end without a proxy. As a result, only RSS feeds that are configured with the appropriate [CORS headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) will load. If the RSS feed you're trying to display fails to load, consider re-hosting the RSS feed or creating your own proxy. # Node graph panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The node graph panel visualizes directed graphs or networks. It uses directed force layout to effectively position the nodes so it can help with displaying complex infrastructure maps, hierarchies, or run diagrams. ## Data requirements The node graph panel requires a specific shape of the data to be able to display its nodes and edges. Not every data source or query can be visualized in this panel. The Node graph visualization consists of *nodes* and *edges*. + A *node* is displayed as a circle. A node might represent an application, a service, or anything else that is relevant from an application perspective. + An *edge* is displayed as a line that connects two nodes. The connection might be a request, an operation, or some other relationship between the two nodes. Both nodes and edges can have associated metadata or statistics. The data source defines what information and values is shown, so different data sources can show different type of values or not show some values. ## Nodes Usually, nodes show two statistical values inside the node and two identifiers just below the node, usually name and type. Nodes can also show another set of values as a color circle around the node, with sections of different color represents different values that should add up to 1. For example, you can have the percentage of errors represented by red portion of the circle. Additional details can be displayed in a context menu, which is displayed when you choose the node. There also can be additional links in the context menu that can target either other parts of the Grafana workspace or any external link. **Note** Node graph can show only 1,500 nodes. If this limit is crossed, a warning is visible in the upper right corner, and some nodes will be hidden. You can expand hidden parts of the graph by clicking on the **Hidden nodes** markers in the graph. ## Edges Edges can also show statistics when you hover over the edge. Similar to nodes, you can open a context menu with additional details and links by choosing the edge. The first data source supporting this visualization is the AWS X-Ray data source for its service map feature. For more information, see [Connect to an AWS X-Ray data source](x-ray-data-source.md). ## Navigating the node graph You can pan within the node graph by choosing outside of any node or edge and dragging the pointer. You can zoom by using the buttons on the upper left corner of the node graph. **Hidden nodes** The number of nodes shown at a given time is limited to maintain a reasonable performance. Nodes that are outside this limit are hidden behind clickable markers that show an approximate number of hidden nodes that are connected to that edge. You can choose the marker to expand the graph around that node. **Grid view** You can switch to the grid view to have a better overview of the most interesting nodes in the graph. Grid view shows nodes in a grid without edges and can be sorted by stats shown inside the node or by stats represented by the a colored border of the nodes. To sort the nodes, choose the stats inside the legend. The marker next to the stat name shows which stat is currently used for sorting and sorting direction. Choose the node and then the **Show in Graph layout** option to switch back to graph layout with focus on the selected node, to show it in context of the full graph. ## Data API This visualization needs a specific shape of the data to be returned from the data source in order to correctly display it. Node Graph at minimum requires a data frame describing the edges of the graph. By default, node graph will compute the nodes and any stats based on this data frame. Optionally a second data frame describing the nodes can be sent in case there is need to show more node specific metadata. You have to set `frame.meta.preferredVisualisationType = 'nodeGraph'` on both data frames or name them `nodes` and `edges` respectively for the node graph to render. **Edges data from structure** Required fields: | Field name | Type | Description | | --- | --- | --- | | id | string | Unique identifier of the edge. | | source | string | Id of the source node. | | target | string | Id of the target. | Optional fields: | Field name | Type | Description | | --- | --- | --- | | mainstat | string/number | First stat shown in the overlay when hovering over the edge. It can be a string showing the value as is or it can be a number. If it is a number, any unit associated with that field is also shown | | secondarystat | string/number | Same as mainStat, but shown right under it. | | detail\$1\$1\$1 | string/number | Any field prefixed with `detail__` will be shown in the header of context menu when clicked on the edge. Use `config.displayName` for a more human readable label. | **Nodes data from structure** Required fields: | Field name | Type | Description | | --- | --- | --- | | id | string | Unique identifier of the node. This ID is referenced by edge in its source and target field. | Optional fields: | Field name | Type | Description | | --- | --- | --- | | title | string | Name of the node visible in just under the node. | | subtitle | string | Additional, name, type or other identifier shown under the title. | | mainstat | string/number | First stat shown inside the node itself. It can either be a string showing the value as is or a number. If it is a number, any unit associated with that field is also shown. | | secondarystat | string/number | Same as mainStat, but shown under it inside the node. | | arc\$1\$1\$1 | number | Any field prefixed with `arc__` will be used to create the color circle around the node. All values in these fields should add up to 1. You can specify color using `config.color.fixedColor`. | | detail\$1\$1\$1 | string/number | Any field prefixed with `detail__` will be shown in the header of context menu when clicked on the node. Use `config.displayName` for more human readable label. | # Pie chart panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The pie chart displays reduced series, or values in a series, from one or more queries, as they relate to each other, in the form of slices of a pie. The arc length, area and central angle of a slice are all proportional to the slices value, as it relates to the sum of all values. This type of chart is best used when you want a quick comparison of a small set of values in an aesthetically pleasing form. ## Value options Use the following options to refine the value in your visualization. **Show** Choose how much information to show. + **Calculate** – Reduces each value to a single value per series. + **All values** – Displays every value from a single series. **Calculation** Select a calculation to reduce each series when Calculate has been selected. For information about available calculations, refer to [Calculation types](v9-panels-calculation-types.md). **Limit** When displaying every value from a single series, this limits the number of values displayed. **Fields** Select which field or fields to display in the visualization. Each field name is available on the list, or you can select one of the following options: + **Numeric fields** – All fields with numerical values. + **All fields** – All fields that are not removed by transformations. + **Time** – All fields with time values. ## Pie chart options Use these options to refine how your visualization looks. **Pie chart type** Select the pie chart display style. Can be either: + **Pie** – A standard pie chart + **Donut** – A pie chart with a hole in the middle **Labels** Select labels to display on the pie chart. You can select more than one. + **Name** – The series or field name. + **Percent** – The percentage of the whole. + **Value** – The raw numerical value. Labels are displayed in white over the body of the chart by default. You can select darker chart colors to make them more visible. Long names or numbers might be clipped. **Tooltip mode** When you hover your cursor over the visualization, Grafana can display tooltips. Choose how tooltips behave. + **Single** – The hover tooltip shows only a single series, the one that you are hovering over on the visualization. + **All** – The hover tooltip shows all series in the visualization. Grafana highlights the series that you are hovering over in bold in the series list in the tooltip. + **Hidden** – Do not display the tooltip when you interact with the visualization. Use an override to hide individual series from the tooltip. **Legend mode** Use these settings to define how the legend appears in your visualization. For more information about the legend, refer to [Configure a legend](v9-panels-configure-legend.md). + **List** – Displays the legend as a list. This is a default display mode of the legend. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** Choose where to display the legend. + **Bottom** – Below the graph. + **Right** – To the right of the graph. **Legend values** Choose which of the [standard calculations](v9-panels-calculation-types.md) to show in the legend. You can have more than one. Select values to display in the legend. You can select more than one. + **Percent** – The percentage of the whole. + **Value** – The raw numerical value. For more information about the legend, refer to [Configure a legend](v9-panels-configure-legend.md). # Plotly panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Plotly panel renders charts using [Plotly](https://plotly.com/javascript/), an open source javascript graphing library. The **Data**, **Layout** and **Config** fields match the common parameters described in the [Plotly documentation](https://plotly.com/javascript/plotlyjs-function-reference/). They must be in JSON format. Data provided by the datasource can be transformed via a user-defined script before to be injected in the Plotly chart. The script includes 2 arguments. + `data` – Data returned by the data source. + `variables` – An object that contains [Grafana variables](templates-and-variables.md) in the current dashboard (user variables and these few global variables: `__from`, `__to`, `__interval`, and `__interval_ms`). The script must return an object with one or more of the following properties: `data`, `layout`, `config` and `frames`. The following is an example. ``` let x = data.series[0].fields[0].values.buffer let y = data.series[0].fields[1].values.buffer let serie = { x : x, y : y, name : variables.project //where project is the name of a Grafana’s variable } return { data : [serie], config : { displayModeBar: false } } ``` Object returned by the script and JSON provided in the *Data*, *Layout* and *Config* fields will be merged (deep merge). If no script is provided, the panel will use only *Data*, *Layout* and *Config* fields. # Sankey panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Sankey panel shows Sankey diagrams, which are good for visualizing flow data, with the width of the flow being proportional to the selected metric. The following image shows a Sankey diagram with two groups of source and destinations. ![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/grafana/latest/userguide/images/sankey-panel.png) **How it works** The sankey panel requires at least 2 columns of data, a source and destination for the flows. Your query should group your data into at least two groups. The panel will draw links from the first column of data points, to the last in order of the query. The thickness of the links will be proportionate to the value as assigned by the metric in the query. **Customizing** + **Links** – There are currently two options for link color: multi or single. It is multi-colored by default. To choose a single color for the links, toggle the **Single Link color only** option and choose your color from Grafana's color picker. + **Nodes** – You can change the color of the rectangular nodes by changing the **Node color** option + **Node Width** – The width of the nodes can be adjusted with the **Node Width** slider or entering a number in the input box. This number must be an integer. + **Node Padding** – The vertical padding between nodes can be adjusted with the **Node Padding** slider or entering a number in the input box. This number must be an integer. If your links are too thin, try adjusting this number + **Headers** – The column headers can be changed by using a **Display Name** override in the editor panel. They will be the same color you choose for **Text color** + **Sankey Layout** – The layout of the Sankey links can be adjusted slightly using the **Layout iteration** slider. This number must be an integer and is the number of relaxation iterations used to generate the layout. # Scatter panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The scatter panel shows an X/Y scatter plot for table data with a simpler interface than other graphing panels. Unlike the graph panel, the scatter panel does not require the data to be in a time series. The scatter panel requires a table formatted dataset with two or more numeric columns of data. One of these can be assigned to the X axis. One or more can be assigned to a series of Y axis values and the resulting data plotted as a series of dots. Each series can optionally also show a regression line using one of a number of statistical best fits. **Creating a scatter panel** The following procedure describes how to create a scatter plot using the scatter panel. For this example, we will assume that there is data, as in the following table called `HEIGHT` with three columns of numerical values, `Age`, `Boys`, and `Girls`, showing the average height of boys and girls by age. | Age | Boy's Height | Girl's Height | | --- | --- | --- | | 5 | 109.7 | 109.5 | | 6 | 115.6 | 115.4 | | 7 | 121.1 | 120.8 | | 8 | 126.3 | 126 | | 9 | 131.3 | 131.3 | | 10 | 136.2 | 137.1 | | 11 | 141.2 | 143.2 | | 12 | 147 | 148.7 | | 13 | 153.6 | 152.6 | | 14 | 159.9 | 155.1 | | 15 | 164.4 | 156.7 | | 16 | 167.3 | 157.6 | | 17 | 169 | 158 | | 18 | 170 | 158.3 | | 19 | 170.8 | 158.6 | **To create a scatter plot with the scatter panel** 1. In your Grafana dashboard, choose **Add Panel**. 1. For the Query, write a query that will return the data needed. In this case, you would use a query such as `SELECT * FROM HEIGHT`. 1. Select the **Scatter** visualization. This will create a scatter plot, using the first column as the X axis, and the other numeric columns as Y axes. **Configuration options** The scatter panel provides the following four custom configuration options. + **X Axis** – You can choose which field to use as the X axis, as well as extents and title and display information for the axis. + **Y Axis** – You can choose which fields to display on the Y axis, including display options for each field, and extents and title information for the axis. You can also choose to display a regression line for each field. See the following information for more details on regression line configuration. + **Legend** – You can turn a legend for the panel on or off, as well as choose the size of the text in the legend. + **Display** – You can set other options for the chart, including grid color and border style. **Regression line configuration** Each Y axis dataset can display a line, in addition to the individual dots. There are five options for the line type. + **None** – Do not display a regression line. + **Simple** – Display a regression line that connects the dataset points. + **Linear** – Display a straight line, using the least-squares, best-fit method. + **Exponential** – Display an exponential best-fit regression line. + **Power** – Display a power best-fit regression line. # Stat panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Stat panel visualization shows a one large stat value with an optional graph sparkline. You can control the background or value color using thresholds. By default, the Stat panel displays one of the following: + Just the value for a single series or field. + Both the value and name for multiple series or fields. You can use the **Text mode** to control whether the text is displayed or not. ## Automatic layout adjustment The panel automatically adjusts the layout depending on available width and height in the dashboard. It automatically hides the graph (sparkline) if the panel becomes too small. ## Value options Use the following options to refine how your visualization displays the value: **Show** Choose how Grafana displays your data. **Calculate** Show a calculated value based on all rows. + **Calculation** – Select a reducer function that Grafana will use to reduce many fields to a single value. For a list of available calculations, see [standard calculations](v9-panels-calculation-types.md). + **Fields** – Select the fields display in the panel. **All values** Show a separate stat for every row. If you select this option, then you can also limit the number of rows to display. + **Limit** – The maximum number of rows to display. Default is 5,000. + **Fields** – Select the fields display in the panel. ## Stat styles Style your visualization. **Orientation** Choose a stacking direction. + **Auto** – Grafana selects what it thinks is the best orientation. + **Horizontal** – Bars stretch horizontally, left to right. + **Vertical** – Bars stretch vertically, top to bottom. **Text mode** You can use the Text mode option to control what text the panel renders. If the value is not important, only the name and color is, then change the **Text mode** to **Name**. The value will still be used to determine color and is displayed in a tooltip. + **Auto** – If the data contains multiple series or fields, show both name and value. + **Value** – Show only value, never name. Name is displayed in the hover tooltip instead. + **Value and name** – Always show value and name. + **Name** – Show name instead of value. Value is displayed in the hover tooltip. + **None** – Show nothing (empty). Name and value are displayed in the hover tooltip. **Color mode** Select a color mode. + **Value** – Colors only the value and graph area. + **Background** – Colors the background as well. **Graph mode** Select a graph and sparkline mode. + **None** – Hides the graph and only shows the value. + **Area** – Shows the area graph below the value. This requires that your query returns a time column. **Text alignment** Choose an alignment mode. + **Auto** – If only a single value is shown (no repeat), then the value is centered. If multiple series or rows are shown, then the value is left-aligned. + **Center** – Stat value is centered. Text size Adjust the sizes of the gauge text. + **Title** – Enter a numeric value for the gauge title size. + **Value** – Enter a numeric value for the gauge value size. # State timeline panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The state timeline panel visualization shows discrete state changes over time. Each field or series is rendered as its unique horizontal band. State regions can either be rendered with or without values. This panel works well with string or boolean states but can also be used with time series. When used with time series, the thresholds are used to turn the numerical values into discrete state regions. ## State timeline options Use these options to refine your visualizations: **Merge equal consecutive values** Controls whether Grafana merges identical values if they are next to each other. **Show values** Controls whether values are rendered inside the state regions. Auto will render values if there is sufficient space. **Align values** Controls value alignment inside state regions. **Row height** Controls space between rows. 1 = no space = 0.5 = 50% space. **Line width** Controls the line width of state regions. **Fill opacity** Controls the opacity of state regions. ## Value mappings To assign colors to boolean or string values, use [Configure value mappings](v9-panels-configure-value-mappings.md). ## Time series data with thresholds The panel can be used with time series data as well. In this case, the thresholds are used to turn the time series into discrete colored state regions. ## Legend options When the legend option is enabled, it can show either the value mappings or the threshold brackets. To show the value mappings in the legend, it’s important that the Color scheme option under Standard options is set to Single color or Classic palette. To see the threshold brackets in the legend, set the Color scheme to From thresholds. **Legend mode** Use these settings to refine how the legend appears in your visualization. + **List ** – Displays the legend as a list. This is a default display mode of the legend. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** Choose where to place the legend. + **Bottom ** – Below the graph. + **Right** – To the right of the graph. **Legend values** Choose which of the [standard calculations](v9-panels-calculation-types.md) to show in the legend. You can have more than one. # Status history panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The Status history visualization shows periodic states over time. Each field or series is rendered as a horizontal row. Boxes are rendered and centered around each value. Status history visualization works with string, boolean, and numerical fields or time series. A time field is required. You can use value mappings to color strings or assign text values to numerical ranges. ## Display options Use these options to refine your visualizations: **Show values** Controls whether values are rendered inside the value boxes. Auto will render values if there is sufficient space. **Column width** controls the width of boxes. 1=max and 0=Min width. **Line width** controls line width of state regions. **Fill opacity** controls the fill opacity of state regions. ## Value mappings To assign colors to boolean or string values, use [Configure value mappings](v9-panels-configure-value-mappings.md). ## Time series data with thresholds The panel can be used with time series data as well. In this case, the thresholds are used to color the boxes. You can also use gradient color schemes to color values. ## Legend options When the legend option is enabled, it can show either the value mappings or the threshold brackets. To show the value mappings in the legend, it’s important that the Color scheme option under Standard options is set to Single color or Classic palette. To see the threshold brackets in the legend set the Color scheme to From thresholds. **Legend mode** Use these settings to refine how the legend appears in your visualization. + **List ** – Displays the legend as a list. This is a default display mode of the legend. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** Choose where to place the legend. + **Bottom ** – Below the graph. + **Right** – To the right of the graph. **Legend values** Choose which of the [standard calculations](v9-panels-calculation-types.md) to show in the legend. You can have more than one. # Table panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The table panel visualization is very flexible, supporting multiple modes for time series and for tables, annotation, and raw JSON data. This panel also provides date formatting, value formatting, and coloring options. ## Sort column Click a column title to change the sort order from default to descending to ascending. Each time you click, the sort order changes to the next option in the cycle. You can only sort by one column at a time. ## Table options **Show header** Show or hide column names imported from your data source. ## Column width By default, Grafana automatically calculates the column width based on the table size and the minimum column width. This field option can override the setting and define the width for all columns in pixels. For example, if you enter `100` in the field, then when you click outside the field, all the columns will be set to 100 pixels wide. ## Minimum column width By default, the minimum width of the table column is 150 pixels. This field option can override that default and will define the new minimum column width for the table panel in pixels. For example, if you enter `75` in the field, then when you click outside the field, all the columns will scale to no smaller than 75 pixels wide. For small-screen devices, such as smartphones or tablets, reduce the default `150` pixel value to `50` to allow table based panels to render correctly in dashboards. ## Column alignment Choose how Grafana should align cell contents: + Auto (default) + Left + Center + Right ## Cell type By default, Grafana automatically chooses display settings. You can override the settings by choosing one of the following options to set the default for all fields. Additional configuration is available for some cell types. **Note** If you set these in the **Field** tab, then the type will apply to all fields, including the time field. You can set them in the **Override** tab to apply the change to one or more fields. **Color text** If thresholds are set, then the field text is displayed in the appropriate threshold color. **Color background (gradient or solid)** If thresholds are set, then the field background is displayed in the appropriate threshold color. **Gauge** Cells can be displayed as a graphical gauge, with several different presentation types. **Basic** The basic mode will show a simple gauge with the threshold levels defining the color of gauge. **Gradient** The threshold levels define a gradient. **LCD** The gauge is split up in small cells that are lit or unlit. **JSON view** Shows value formatted as code. If a value is an object the JSON view allowing browsing the JSON object will appear on hover. ## Cell value inspect Enables value inspection from table cell. The raw value is presented in a modal window. **Note** Cell value inspection is only available when cell display mode is set to Auto, Color text, Color background or JSON View. ## Column filter You can temporarily change how column data is displayed. For example, you can order values from highest to lowest or hide specific values. For more information, refer to [Filter table columns](#v9-panels-table-filter), below. ## Pagination Use this option to enable or disable pagination. It is a front-end option that does not affect queries. When enabled, the page size automatically adjusts to the height of the table. ## Filter table columns If you turn on the **Column filter**, then you can filter table options. **To turn on column filtering** 1. In Grafana, navigate to the dashboard with the table with the columns that you want to filter. 1. On the table panel you want to filter, open the panel editor. 1. Choose the **Field** tab. 1. In **Table** options, turn on the **Column filter** option. A filter icon appears next to each column title. **Filter column values** To filter column values, choose the filter (funnel) icon next to a column title. Grafana displays the filter options for that column. Choose the check box next to the values that you want to display. Enter text in the search field at the top to show those values in the display so that you can select them rather than scroll to find them. **Clear column filters** Columns with filters applied have a blue funnel displayed next to the title. To remove the filter, choose the blue funnel icon and then select Clear filter. ## Table footer You can use the table footer to show [calculations](v9-panels-calculation-types.md) on fields. After you enable the table footer, you can select the **Calculation**, and then the **Fields** that you want to calculate. The system applies the calculation to all numeric fields if you do not select a field. **Count rows** If you want to show the number of rows in the dataset instead of the number of values in the selected fields, select the **Count** calculation and enable **Count rows**. # Text panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The text panel enables you to directly include text or HTML in your dashboards. This can be used to add contextual information and descriptions or embed complex HTML. **Mode** Mode determines how embedded content appears. It has the following options + **Markdown** – This option formats the content as markdown. + **HTML** – This setting renders the content as sanitized HTML. + **Code** – This setting renders content inside a read-only code editor. Select an appropriate language to apply syntax highlighting to the embedded text. **Variables** Variables in the content will be expanded for display. # Time series panel **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The time series panel can render a time series as a line, a path of dots, or a series of bars. This type of graph is versatile enough to display almost any time-series data. **Note** You can migrate Graph panel visualizations to Time series visualizations. To migrate, on the **Panel** tab, choose **Time series visualization**. Grafana transfers all applicable settings. **Topics** + [Tooltip options](v9-time-series-panel-tooltip.md) + [Legend options](v9-time-series-panel-legend.md) + [Graph style options](v9-time-series-graph.md) + [Axis options](v9-time-series-axis.md) + [Color options](v9-time-series-color.md) # Tooltip options **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). When you hover your cursor over the graph, Grafana can display tooltips. Choose how tooltips behave: + **Single** – The hover tooltip shows only the series that you are hovering over. + **All** – The hover tooltip shows all the series in the graph. Grafana highlights the series that you are hovering over in bold in the series list in the tooltip. + **Hidden** – Do not display the tooltip. # Legend options **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). **Legend mode** – Choose how the legend appears. + **List** – Displays the legend as a list. This is the default. + **Table** – Displays the legend as a table. + **Hidden** – Hides the legend. **Legend placement** – Choose where to display the legend. + **Bottom** – Below the graph. + **Right** – To the right of the graph. **Legend calculations** Choose which calculations to show in the legend. For more information, see [Calculation types](v9-panels-calculation-types.md). # Graph style options **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). **Graph style** Use this option to define how to display your time series data. You can use overrides to combine multiple styles in the same graph. There are three style options. Some of the other style options only apply to certain graph styles. + **Lines** – Display the time series as a line on a graph. + **Bars** – Display the time series as a series of bars on a graph, one for each data point. + **Points** – Display the time series as dots on a graph, one for each data point. **Bar alignment** For bar graphs, , sets the position of the bar, relative to where the point would be drawn on the graph. Because a bar has a width, it can be placed before, after, or centered on the point. The choices for this option are **Before**, **Center**, or **After**. **Line width** Sets the thickness of the line for Line graphs, or the thickness of the outline for each bar in a bar graph. **Fill opacity** Sets the opacity of a fill color. Fills are used, for example, to show the area under the line in a line graph, or as the color of bars in a bar graph. **Gradient mode** Gradient mode specifies the gradient fill, which is based on the series color. To change the color, use the standard color scheme field option. For more information, see [Color scheme](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme). The gradient mode options are: + **None** – No gradient fill. + **Opacity** – An opacity gradient where the opacity of the fill increases as the Y-axis values increase. + **Hue** – A gradient that is based on the hue of the series color. + **Scheme** – A color gradient defined by your color scheme. This setting can be used by the fill and the line. For more information, see [Color options](v9-time-series-color.md). The gradient appearance is also modified by the **Fill opacity** setting. **Show points** You can configure your visualization to add points to line or bar graphs. You can choose **Always**, **Never**, or **Auto**. When using **Auto**, Grafana determines whether to show points based on the density of the data. If the density of the data is low enough, points are shown. **Point size** Sets the size of drawn points, from 1 to 40 pixels in diameter. **Line interpolation** Choose how Grafana interpolates the series line. The choices are **Linear**, **Smooth**, **Step before**, and **Step after**. **Line style** Set the style of the line. To change the color, use the standard color scheme field option. Line style appearance is influenced by the settings for **Line width** and **Fill opacity**. The choices for line style are **Solid**, **Dash**, and **Dots**. **Connect null values** Choose how null values (gaps in the data) appear on the graph. Null values can be connected to form a continuous line or, optionally, set a threshold above which gaps in the data should no longer be connected. You can choose to **Never** connect data points with gaps, **Always** connect data points with gaps, or set a **Threshold** at which gaps in the data should no longer be connected. **Stack series** *Stacking* allows Grafana to display series on top of each other. Be cautious when using stacking in the visualization as it can easily create misleading graphs. To read more about why stacking might not be the best approach, refer to [The Issue with Stacking](https://www.data-to-viz.com/caveat/stacking.html). The options for stacking are: + **Off** – Turns off series stacking. + **Normal** – Stacks series on top of each other. + **100%** – Stack by percentage, where all series together add up to 100%. **Stack series in groups** You can override the stacking behavior to stack series in groups. For more information about creating an override, see [Configure field overrides](v9-panels-configure-overrides.md). When creating the override, give the name of the stacking group you want the series to be part of. **Fill below to** The **Fill below to** option fills the area between two series. This options is only available as a series or field override. Using this option you can fill the area between two series, rather than from the series line down to 0. For example, if you had two series called *Max* and *Min*, you could select the **Max** series and override it to **Fill below to** the **Min** series.. This would fill only the area between the two series lines. # Axis options **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). Options under the axis category change how the X and Y axes are rendered. Some options do not take effect until you click outside of the field option box you are editing. You can also or press `Enter`. **Placement** Select the placement of the Y-axis. The options are: + **Auto** – Grafana automatically assigns the Y-axis to the series. When there are two or more series with different units, Grafana assigns the left axis to the first unit, and the right axis to the units that follow. + **Left** – Display all Y-axes on the left side. + **Right** – Display all Y-axes on the right side. + **Hidden** – Hide all Y-axes. To assign axes for each field or series, [add field overrides](v9-panels-configure-overrides.md). **Label** Set a Y-axis text label. If you have more than one Y-axis, then you can assign different labels using an override. **Width** Set a fixed width of the axis. By default, Grafana dynamically calculates the width of an axis. By setting the width of the axis, data with different axes types can share the same display proportions. This setting makes it easier for you to compare more than one graph’s worth of data because the axes are not shifted or stretched within visual proximity to each other. **Soft min and soft max** Set a **Soft min** or **soft max** option for better control of Y-axis limits. By default, Grafana sets the range for the Y-axis automatically based on the dataset. Soft min and soft max settings allow visibility into small changes when big changes aren't present. Hard min or max derived from standard min and max field options can prevent intermittent spikes from flattening useful detail by clipping the spikes past a specific point. To define hard limits of the Y-axis, You can set standard min/max options. For more information, refer to [Configure standard options](v9-panels-configure-standard-options.md). **Scale** Set how the Y-axis scales. The choices are **Linear** or **Logarithmic**. If you choose logarithmic, you can further choose between base 2 or base 10 logarithmic scales. **Transform** You can override a series to apply a transform to values on a graph (without affecting the underlying values or the values in tooltips, context menus, or legends). You have two transform options: + **Negative Y transform** – Flip the results to negative values on the Y axis. + **Constant** – Show the first value as a constant line. # Color options **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). By default, the graph uses the standard [Color scheme](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme) option to assign series colors. You can also use the legend to open the color picker by clicking the legend series color icon. Setting color this way automatically creates an override rule that set’s a specific color for a specific series. The following are additional options that you can use to override series color defaults. **Classic Palette** The most common setup is to use the **Classic palette** for graphs. This scheme automatically assigns a color for each field or series based on its order. If the order of a field changes in your query, the color also changes. You can manually configure a color for a specific field using an override rule. **Single color** Use this mode to specify a color. You can also click the colored line icon next to each series in the Legend to open the color picker. This automatically creates a new override that sets the color scheme to single color and the selected color. **By value color schemes** If you select a by value color scheme like **From thresholds (by value)** or **Green-Yellow-Red (by value)**, the **Color series by** option appears. This option controls which value (Last, Min, Max) to use to assign the series its color. **Scheme gradient mode** The **Gradient mode** option located under the **Graph styles** has a mode named **Scheme**. When you enable **Scheme**, the line or bar receives a gradient color defined from the selected **Color scheme**. **From thresholds** If the **Color scheme** is set to **From thresholds (by value)** and **Gradient mode** is set to **Scheme**, then the line or bar color changes as they cross the defined thresholds. You will see only the exact colors chosen in the scheme. **Gradient color schemes** Using a gradient color scheme *without* setting the **Gradient mode** to **Scheme**, means that the colors chosen will form a gradient between the colors chosen, as the values in the series move between the thresholds set. # Traces panel (Beta) **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). *Traces* are a visualization that enables you to track and log a request as it traverses the services in your infrastructure. For more information about traces, see [Tracing in Explore](v9-explore-tracing.md). # WindRose **** This documentation topic is designed for Grafana workspaces that support **Grafana version 9.x**. For Grafana workspaces that support Grafana version 12.x, see [Working in Grafana version 12](using-grafana-v12.md). For Grafana workspaces that support Grafana version 10.x, see [Working in Grafana version 10](using-grafana-v10.md). For Grafana workspaces that support Grafana version 8.x, see [Working in Grafana version 8](using-grafana-v8.md). The WindRose panel receives raw time series data converts the data and maps it in a WindRose chart. ![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/grafana/latest/userguide/images/windrose.png) ## Options The WindRose panel supports the following options: + Axis frequency + Axis style (degrees or compass) + Scale (linear, square, log)