Best practices for creating dashboards

    Here are some principles to consider before you create a dashboard.

    What story are you trying to tell with your dashboard? Try to create a logical progression of data, such as large to small or general to specific. What is the goal for this dashboard? (Hint: If the dashboard doesn’t have a goal, then ask yourself if you really need the dashboard.)

    Cognitive load is basically how hard you need to think about something in order to figure it out. Make your dashboard easy to interpret. Other users and future you (when you’re trying to figure out what broke at 2AM) will appreciate it.

    Ask yourself:

    • If I show this to someone else, how long will it take them to figure it out? Will they get lost?

    Refer to Common observability strategies and for more information.

    Once you have a strategy or design guidelines, write them down to help maintain consistency over time. Check out this .

    Best practices to follow

    • When creating a new dashboard, make sure it has a meaningful name.
      • If you are creating a dashboard to play or experiment, then put the word or in the name.
      • Consider including your name or initials in the dashboard name or as a tag so that people know who owns the dashboard.
      • Remove temporary experiment dashboards when you are done with them.
    • If you create many related dashboards, think about how to cross-reference them for easy navigation. Refer to for more information.
    • Avoid unnecessary dashboard refreshing to reduce the load on the network or backend. For example, if your data changes every hour, then you don’t need to set the dashboard refresh rate to 30 seconds.
    • Use the left and right Y-axes when displaying time series with different units or ranges.
    • Add documentation to dashboards and panels.
      • To add documentation to a dashboard, add a Text panel visualization to the dashboard. Record things like the purpose of the dashboard, useful resource links, and any instructions users might need to interact with the dashboard. Check out this .
      • To add documentation to a panel, edit the panel settings and add a description. Any text you add will appear if you hover your cursor over the small in the top left corner of the panel.
    • Reuse your dashboards and enforce consistency by using templates and variables.