What do I need to consider when designing a custom dashboard?
A custom dashboard lets the user display a specific set of metrics and data points on a single screen. Custom dashboards can show application, server, and database metrics reported by AppDynamics Agents.
By presenting metrics of interest to a specific audience, custom dashboards offer a supplement to AppDynamics' built-in dashboards.
FAQ
How can I create a sample custom dashboard?
Use the JSON file in each of the following links to create a custom dashboard.
What are some best practices when designing custom dashboards?
C
onsider the following approach:
- Identify the list of key metrics that the dashboard should display.
- For each metric, determine the appropriate widget to render the metric data.
- Sometimes a chart representation works best. Other times a metric value will be sufficient. Some data is best displayed in a pie chart.
- Design health rules that represent the health of business transaction, service or subcomponent.
- Consider the appropriate health rule thresholds carefully to avoid false alerts, especially for critical violations.
- Note that unlike alerts, status lights do not indicate which condition or which node, tier or business transaction violated the health rule.
- Health rules that will be used for status lights, therefore, need to be specific to a given node, tier or business transaction.
- Design the dashboard layout.
- Consider how to fit all the metrics on the dashboard, and which layout best presents the data.
- Pick a color scheme, not just for visual appeal, but also to make the data stand out.
- Once built, plan for a tuning period.
- For example, the time range might need to be adjusted, or health rule thresholds changed, to avoid false alerts.
- After encountering a production issue, evaluate each dashboard, and identify what additional metrics should be captured, and what changes should be made, in case the same or a similar issue happens again. If needed, design additional dashboards.
- Do create dashboards that watch metrics associated with previous production issues.
What are some things to avoid?
The best dashboards have enough metrics to be informative, but not so many as to cause performance issues or become confusing to the users. The exact number of metrics depends on your team.
Additionally:
- Don't make dashboards larger than your screen resolution. A custom dashboard that requires scrolling is not ideal.
- Don't set the refresh timing to 60 seconds as 5 minutes is usually sufficient.
What kinds of custom dashboards can a user create?
Different custom dashboards
are of interest to different teams:
- Executive Dashboards - The executive dashboards should include a number of status lights for each key user or system journey step health and performance, as well as any KPI or SLA metrics. These dashboards also show any business metrics or impact information.
- Operations Dashboards - The operations dashboards should include a number of status lights for each service (tier and/or Top BT), to provide a global overview of the health of the application infrastructure. These dashboards can also contain an Events List.
- Application Dashboard - These dashboards target an application and show the health of key business transactions, highlighting call volumes, response times, and error rates (for a given application or tier). It also uses status lights to indicate the health of each top business transaction.
- Service Dashboards - These dashboards each target an individual service and show key health metrics for the service (tier), including the call volume, response time and error rate for the service overall as well as for important API calls. The service dashboard can also show CPU and memory consumption as well as garbage collection statistics for each node in the tier. A corresponding status light that provides a visual health indicator can accompany each metric.
Can a read-only user edit a custom dashboard?
Yes, if the read-only user is given permission to edit a custom dashboard on the Administration page.
- As an Admin, click the gear icon in the Controller UI.
- Select Administration from the drop-down menu.
- Click on the Roles tab.
- Select the read-only user's name from the list of usernames on the left.
- Click on the Custom Dashboards tab.
- Use the checkboxes to allow the read-only user to view, edit, or delete custom dashboards.
- Click the Save button.
Can a user change a dashboard's name and metric series' color?
Yes, anyone with permission to edit custom dashboards can edit the name and colors.
- Click on the Dashboards & Reports tab in the Controller UI.
- Click on the pencil icon.
- Select Edit Dashboard Properties from the drop-down menu.
Edit dashboard name: 
Edit metric series colors: 
If you have an active AppDynamics account, visit AppDynamics University and enroll in the "Custom Dashboards and Dashboard Templates" self-paced course to learn how to build your own custom dashboards. Standard self-paced courses are available to Standard University subscribers, and are available at no cost to AppDynamics customers.
AppDynamics also offers the "APM223 - Proactive Monitoring and Dashboards" instructor-led course for more insight on creating dashboards, reports, and widgets. Instructor-led courses are available to Premium University subscribers; contact your Account Manager for pricing.
Visit the AppD University Group Hub for University FAQs and how-to articles.
