Skip to main content
This page provides more detailed information about how some dashboard charts options work. For all other options, please see the help icon with attached tooltip for more information. AppSignal has two kinds of dashboard:
  • Custom dashboards that you build. Select Add dashboard in the app’s sidebar to create one, then Add chart to add charts to it. Any metric your app reports can go on a chart, including custom metrics, and the Metric field suggests the names your app currently reports.
  • Intelligence dashboards that AppSignal creates the first time it recognizes metrics from a supported integration, such as Sidekiq, NGINX, Kubernetes, or an AWS service. They carry an Intelligence badge, and when AppSignal improves one, the dashboard offers you the update.
Open the dashboard and chart builder in your app.

Charts types

Some data is better understood if the chart is rendered in a different way. We provide the following display options:
  • Number chart
  • Line graph
  • Area graph
  • Relative area graph
Charts load their data from the Public API (V2). A chart shows at most 100 series, counting each field separately, and does not indicate when series are left out.

Number chart

The number chart, also called a Big Number, shows the value of a metric as a large number. This is useful for metrics that represent a single value, such as error count or request count. Big Number Value chart example A number chart takes one metric and one aggregation across the time range selected on the dashboard or preview:
  • Metric — The metric name to be shown in this chart. Use the full metric name to select one metric, or a wildcard (*) to select several at once: db_users_document_count, db_*_size. See metric naming for the full rules.
  • Aggregation type — How the value on the chart is selected or calculated from the metric data in the selected time frame:
    • Maximum value — the highest metric value
    • Minimum value — the lowest metric value
    • Average value — the average of the metric values
    • Total value — the combined value of the metric values
    • First value — the first metric value
    • Last value — the last metric value
  • Data format — The value format used to display values in the chart and chart legends. See value formatting for the available formats.
  • Tags (optional) — Which tags of the metric to display in the chart. When empty, every variation of a tag gets its own entry. Enter tags to filter for certain tag values; in that case, all tags of the metric need to be specified, either with a value or a wildcard. See metric tags for the full reference.
Number chart setup in the chart builder You can also create a number chart from an AI agent instead of the chart builder. See create_dashboard_visual in the MCP tool reference.

Line, area, and relative area graphs

When selecting the “Line graph”, the default graph type is “Line graph”. Use “Area graph” to render areas beneath the lines and “Relative area graph” to render a graph with the relative values of each data point. This renders a percentage for each data point from 0–100 and fills out the graph accordingly. This can be used to easily show the relation between data points in a graph. The image below shows the same metric in all three graph types. In the Line and Area graph you can see that the amount of data has increased, but the Relative area graph at the bottom shows that the relation between transmitted/received has not changed over time. Graph display example

Hide lines on a chart

Hover over a line chart to see the value of each line. Select a line in that list to hide it, or select it again to show it. Hidden lines move to the bottom of the list, under 1 hidden, for example. Select show all to show them again.
A fullscreen Throughput chart showing the web and background lines. In the side panel, admin is listed under 1 hidden, with a show all link.

Select a line in the list to hide it.

To show only one line, hold Cmd or Alt while you select it.
A fullscreen Throughput chart showing only the background line. In the side panel, web and admin are listed under 2 hidden, with a show all link.

Hold Cmd or Alt and select a line to show only that line.

The lines you hide stay hidden after you reload the page, and in the chart’s fullscreen view. AppSignal remembers them in your browser for the last 50 charts you changed.

Change the time range and compare in fullscreen

To open an AppSignal dashboard chart in fullscreen mode:
  1. Open your app’s dashboard, or one of your custom dashboards.
  2. Select the expand icon (Open fullscreen) at the top right of a line graph, or select the graph’s title. Only line graphs open in fullscreen mode, big number charts, for instance, do not.
In fullscreen mode:
  • Change the time range. Open the time range menu, then pick a preset from 1 hour (1H) to 30 days (30D), or pick a start and end date in the calendar. Set the times in From and To. The menu button shows the length of the range, such as 4H, next to its dates.
  • Compare with an earlier time range. Select Compare, next to the time range menu, and pick one of the following options. Each option shows the dates it compares with.
    • Previous period: the same length of time, right before the chart’s range.
    • 1D before: the same range one day earlier. It shows when the range is shorter than a day.
    • 7D before: the same range one week earlier. It shows when the range is shorter than a week.
    • Custom start date: pick the day the comparison starts in the calendar, set the Start time, and select Add. When you hover over a day, the calendar outlines the days the comparison covers. For example, if the chart shows today from 13:00 to 14:00, pick yesterday and set the start time to 13:00 to compare it with the same hour yesterday.
    The comparison covers the same length as the time range you defined, and shows as dotted lines on the same y-axis as the chart. The Compare button then shows the comparison’s dates. Select Clear comparison to remove it.
A fullscreen Throughput chart with the time range menu open. The button reads 1H, 12th Nov 12:54 - 12th Nov 13:54. The menu shows presets from 1H to 30D, a calendar for November 2026, and From and To time fields.

Pick a preset, or pick your own dates and times.

A fullscreen Throughput chart over 48 hours, compared with the 48 hours before. The Compare menu is open and shows Previous period and 7D before, each with its dates, and Custom start date. Dotted lines show the comparison.

Pick an earlier time range to compare with.

NULL values

Not always does every point in time have a value for a metric, yet the value is not 0. In our system we do not record a value for this time and treat this point as NULL rather than 0. This means no value is present and can be interpreted in two ways. Either it was actually 0 or it retains the value of the last known data point in the graph. The “NULL values” option (“Draw NULL as 0” by default) allows for the configuration of the draw behavior for a graph. If set to “Draw NULL as 0” it will treat the NULL value as 0. If set to “Repeat last known value” it will repeat the last known value until a later point in time specifies a new value. See the difference in the graph below. With “Draw NULL as 0” the graph makes a sharp drop to 0 every time the app stopped reporting data. With “Repeat last known value” the graph looks less volatile in terms of lines moving up and down. Draw NULL as 0 option graph comparison screenshot The app used to generate these graphs: