Insights & Metrics
The Insights & Metrics panel, located in the application view of the VIP Dashboard, provides insights into the performance, health, and usage of an application.
Access data related to an environment’s performance by selecting one of the displayed tabs labeled:
- HTTP: The performance of responses to HTTP requests.
- Resource Usage: The performance of an environment’s infrastructure-level resources.
- Database: The size and health of an environment’s database.
- Cache: Metrics for cache utilization by an environment.
For all data displayed throughout all views of the Insights & Metrics panel:
- Timestamps are formatted in Coordinated Universal Time (UTC).
- Users can interact with available settings to modify the time frame and format of the data that is displayed.
Access
Prerequisites
To access the Insights & Metrics panel, a user must have at minimum an Org member role or an App read role for that application.
To access the Insights & Metrics panel:
- Navigate to the VIP Dashboard for an application.
- Select “Performance” from the sidebar navigation at the left of the screen.
- Select “Insights & Metrics” from the submenu.
The Insights & Metrics panel is environment-specific (e.g., production, develop). A different environment type can be selected from the dropdown at the upper left of the VIP Dashboard application view.
Display data for a specific time period
By default, data from the most recent ” Previous 3 days” (72 hours) is displayed for an environment.
Datepicker time selection
A user can select a preset list of time periods or enter custom time periods for environment data in a datepicker. To access the datepicker, select the field in the upper right of the panel that displays timestamps for the date range of the currently displayed data.
A user can select from a displayed list of preset windows of time for the “Previous 30 minutes”, or up to the “Previous 90 days”.
More specific periods of time can be selected by entering dates in the “From” and “To” fields in the section of the datepicker labeled “Date Range”. The range of data displayed can be further specified by enabling the option labeled “Custom time” and entering times (in UTC) for the “From” and “To” time range fields. Select the button labeled “Apply” to save the settings and refresh the displayed data.
Manual time selection
As an alternative to the datepicker, a time range can be manually selected within data that is displayed in chart format. Using a mouse, select a timestamp within the x-axis of the chart. Hold the mouse button down while dragging across to a second timestamp along the x-axis, and release the mouse button. The data displayed within the chart will refresh and display only the data that exists within the first and second timestamps that were selected.
Display data as a chart or a table
All data in the Insights & Metrics panel can be displayed in either a chart format (default) or a table format. The display options for “Chart” or “Table” can be selected from the dropdown menu labeled “Show” located in the upper right of the Insights & Metrics panel.
Data Series
When data is displayed in chart format, a legend for the types of displayed data is located at the bottom left of the chart. The legend provides a reference for identifying the types of data that are included in the chart, as well as providing the ability to toggle those data types on and off.
For example, an “HTTP Origin Response Codes” chart displays a Data Series legend item that has a green square to the left of “2xx”. This indicates that data in the chart represented by a green line correlates with “2xx” responses.
The user can select and toggle a Data Series legend item to omit or include its correlating data in the chart.
When a data type is omitted, its icon will have a colored outline and no fill.
Event Types
Events related to code deployments and software version updates that occur on an environment are indicated by Event Types.
Table format
When data is displayed in table format, Event Types that occur within a selected date range will be displayed in the column labeled “Events”. The displayed Event Type is hyperlinked and can be selected to access more information about the event in a related VIP Dashboard panel.
Chart format
Within a chart, a user can select an Event Type icon to access more information about the event. Selecting an Event Type reveals the event’s date, timestamp, and description, and a link to more detailed information.
- Code deployment events are represented by a capital “D” within a blue circle.
- Software version update events are represented by a capital “U” within a green circle.
Legend
If Event Types occur within the time period being viewed for a chart, a legend for those Event Types will be located below the chart. A user can select and toggle an Event Type in the legend in order to omit or include them within the chart.
When an Event Type is omitted from the displayed data, its icon will have a colored outline but no fill within the legend.
Link to New Relic dashboard
For environments that have New Relic enabled, a button labeled “View Application in New Relic” will be displayed in the upper right of the panel. Select the button to access the environment’s New Relic dashboard and investigate more deeply into response times for various URL routes. New Relic can also be used to identify anomalies such as slow queries, slow remote requests, or generally slow URL routes.
Last updated: April 19, 2024