95f122503 · cryptotaxi247/netdata-1

@@ -1,7 +1,6 @@

1 -# Build Custom Dashboards

1 +# Dashboards tab

2

3 -With Netdata Cloud, you can build custom dashboards that target your infrastructure's unique needs. Put key metrics from

4 -any number of distributed systems in one place for a bird's eye view of your infrastructure.

3 +With Netdata Cloud, you can build **custom dashboards** that target your infrastructure's unique needs. Put key metrics from any number of distributed systems in one place for a bird's eye view of your infrastructure.

4

5 Click on the **Dashboards** tab in any War Room to get started.

6

@@ -9,13 +8,11 @@ Click on the **Dashboards** tab in any War Room to get started.

8

9 From the Dashboards tab, click on the **+** button.

10

12 -<img width="98" alt=" Green plus button " src="https://github.com/netdata/netdata/assets/73346910/511e2b38-e751-4a88-bc7d-bcd49764b7f6"/>

13 -

14 -

11 In the modal, give your custom dashboard a name, and click **+ Add**.

12

17 -- The **Add Chart** button on the top right of the interface adds your first chart card. From the dropdown, select either **All Nodes** or a specific

18 -node. Next, select the context. You'll see a preview of the chart before you finish adding it. In this modal you can also [interact with the chart](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md), meaning you can configure all the aspects of the [NIDL framework](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md#nidl-framework) of the chart and more in detail, you can:

13 +- The **Add Chart** button on the top right of the interface adds your first chart card. From the dropdown, select either **All Nodes** or a specific node.

14 +

15 + Next, select the context. You'll see a preview of the chart before you finish adding it. In this modal you can also [interact with the chart](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md), meaning you can configure all the aspects of the [NIDL framework](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md#nidl-framework) of the chart and more in detail, you can:

16 - define which `group by` method to use

17 - select the aggregation function over the data source

18 - select nodes

@@ -26,20 +23,17 @@ node. Next, select the context. You'll see a preview of the chart before you fin

23

24 After you are done configuring the chart, you can also change the type of the chart from the right hand side of the [Title bar](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md#title-bar), and select which of the final dimensions you want to be visible and in what order, from the [Dimensions bar](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md#dimensions-bar).

25

29 -- The **Add Text** button on the top right of the interface creates a new card with user-defined text, which you can use to describe or document a

30 -particular dashboard's meaning and purpose.

26 +- The **Add Text** button on the top right of the interface creates a new card with user-defined text, which you can use to describe or document a particular dashboard's meaning and purpose.

27

28 > ### Important

29 >

30 > Be sure to click the **Save** button any time you make changes to your dashboard.

31

36 -

32 ## Using your dashboard

33

39 -Dashboards are designed to be interactive and flexible so you can design them to your exact needs. Dashboards are made

40 -of any number of **cards**, which can contain charts or text.

34 +Dashboards are designed to be interactive and flexible so you can design them to your needs. They are made from any number of charts and cards, which can contain charts or text.

35

42 -### Chart cards

36 +### Charts

37

38 The charts you add to any dashboard are [fully interactive](https://github.com/netdata/netdata/blob/master/docs/cloud/visualize/interact-new-charts.md), just like any other Netdata chart. You can zoom in and out, highlight timeframes, and more.

39

@@ -47,43 +41,47 @@ Charts also synchronize as you interact with them, even across contexts _or_ nod

41

42 ### Text cards

43

50 -You can use text cards as notes to explain to other members of the [War Room](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/organize-your-infrastrucutre-invite-your-team.md#netdata-cloud-war-rooms) the purpose of the dashboard's arrangement.

44 +You can use text cards as notes to explain to other members of the [War Room](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/organize-your-infrastrucutre-invite-your-team.md#netdata-cloud-war-rooms) the purpose of the dashboard's arrangement.

45

52 -### Move cards

46 +By clicking the `T` icon on the text box, you can switch between font sizes.

47

54 -To move any card, click and hold on **Drag & rearrange** at the top right of the card and drag it to a new location. A red placeholder indicates the

55 -new location. Once you release your mouse, other charts re-sort to the grid system automatically.

48 +### Move elements

49

57 -### Resize cards

50 +To move a chart or a card, click and hold on **Drag & drop** at the top right of each element and drag it to a new location. A green placeholder indicates the

51 +new location. Once you release your mouse, other elements re-sort to the grid system automatically.

52

59 -To resize any card on a dashboard, click on the bottom-right corner and drag to the card's new size. Other cards re-sort

60 -to the grid system automatically.

53 +### Resize elements

54

62 -## Go to chart

55 +To resize any element on a dashboard, click on the bottom-right corner and drag it to its new size. Other elements re-sort to the grid system automatically.

56

64 -Quickly jump to the location of the chart in either the Overview tab or if the card refers to a single node, its single node dashboard by clicking the 3-dot icon in the corner of any card to open a menu. Hit the **Go to Chart** item.

57 +### Go to chart

58 +

59 +Quickly jump to the location of the chart in either the [Metrics tab](https://github.com/netdata/netdata/blob/master/docs/dashboard/metrics-tab-and-single-node-tabs.md) or if the chart refers to a single node, its single node dashboard by clicking the 3-dot icon in the corner of any chart to open a menu. Hit the **Go to Chart** item.

60

61 You'll land directly on that chart of interest, but you can now scroll up and down to correlate your findings with other

62 charts. Of course, you can continue to zoom, highlight, and pan through time just as you're used to with Netdata Charts.

63

64 +### Rename a chart

65 +

66 +Using the 3-dot icon in the corner of any chart, you can rename it to better explain your use case or the visualization settings you've chosen for the chart.

67 +

68 +### Remove an individual element

69 +

70 +Click on the 3-dot icon in the corner of any card to open a menu. Click the **Remove** item to remove the card.

71 +

72 ## Managing your dashboard

73

71 -To see dashboards associated with the current War Room, click the **Dashboards** tab in any War Room. You can select

72 -dashboards and delete them using the 🗑️ icon.

74 +To see dashboards associated with the current War Room, click the **Dashboards** tab in any War Room. You can select dashboards and delete them using the 🗑️ icon.

75

76 ### Update/save a dashboard

77

76 -If you've made changes to a dashboard, such as adding or moving cards, the **Save** button is enabled. Click it to save

77 -your most recent changes. Any other members of the War Room will be able to see these changes the next time they load

78 -this dashboard.

78 +If you've made changes to a dashboard, such as adding or moving elements, the **Save** button is enabled. Click it to save your most recent changes.

79 +

80 +Any other members of the War Room will be able to see these changes the next time they load this dashboard.

81

82 If multiple users attempt to make concurrent changes to the same dashboard, the second user who hits Save will be

83 prompted to either overwrite the dashboard or reload to see the most recent changes.

84

83 -### Remove an individual card

84 -

85 -Click on the 3-dot icon in the corner of any card to open a menu. Click the **Remove** item to remove the card.

86 -

85 ### Delete a dashboard

86

87 Delete any dashboard by navigating to it and clicking the **Delete** button. This will remove this entry from the

@@ -95,7 +93,4 @@ Because of the visual complexity of individual charts, dashboards require a mini

93

94 ## What's next?

95

98 -Once you've designed a dashboard or two, make sure

99 -to [invite your team](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/organize-your-infrastrucutre-invite-your-team.md#invite-your-team) if

100 -you haven't already. You can add these new users to the same War Room to let them see the same dashboards without any

101 -effort.

96 +Once you've designed a dashboard or two, make sure to [invite your team](https://github.com/netdata/netdata/blob/master/docs/cloud/manage/organize-your-infrastrucutre-invite-your-team.md#invite-your-team) if you haven't already. You can add these new users to the same War Room to let them see the same dashboards without any effort.

dashboards doc edits (#17409)