Database Performance Analyzer Integration Module

Transcription

1 ADMINISTRATOR GUIDE Database Performance Analyzer Integration Module Version 11.1 Last Updated: Monday, December 4, 2017 Retrieve the latest version from:

2 2017 SolarWinds Worldwide, LLC. All rights reserved. This document may not be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the prior written consent of SolarWinds. All right, title, and interest in and to the software and documentation are and shall remain the exclusive property of SolarWinds and its respective licensors. SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON SOFTWARE AND DOCUMENTATION FURNISHED HEREUNDER INCLUDING WITHOUT LIMITATION THE WARRANTIES OF DESIGN, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The SolarWinds and other SolarWinds marks, identified on the SolarWinds website, as updated from SolarWinds from time to time and incorporated herein, are registered with the U.S. Patent and Trademark Office and may be registered or pending registration in other countries. All other SolarWinds trademarks may be common law marks or registered or pending registration in the United States or in other countries. All other trademarks or registered trademarks contained and/or mentioned herein are used for identification purposes only and may be trademarks or registered trademarks of their respective companies. Version 11.1, revised: 12/4/2017 page i

3 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Table of Contents Introduction to the DPA Integration Module 1 Architecture of the DPA Integration Module 2 DPA and SAM integration 3 DPA and SRM integration 6 Azure SQL support 11 Integrate DPA with Orion Platform products 14 Integrate DPA and Orion Platform products 14 Requirements for the DPA Integration Module 14 Port requirements 14 DPA server 15 Orion server 15 Browser requirements 15 Next steps 16 Set up the DPA Integration Module 16 Set up the Integration Module in Settings 16 What happens during the integration setup? 16 Manage relationships to database instances, applications, and storage objects 17 Access Relationship Management 17 Database Instances tab 18 Client Applications tab 18 Storage Objects tab 18 Discovery Central 18 DPA Integration Module 19 DPA alerting in the Orion Platform 19 Alert example 20 page ii

4 The scope of alert 20 The actual trigger condition 21 DPA reporting in the Orion Platform 21 Database instances in the AppStack environment 22 Assess database instances in the AppStack 22 Mini-AppStack resource 24 Customize a DPAIM view and apply limitations 24 Restrict access by applying view limitations 25 DPAIM account limitations 25 Restrict access by applying user account limitations 26 Troubleshooting DPAIM issues 27 Troubleshooting environmental issues with Performance Analysis dashboards 29 Compatible SolarWinds products 29 Create analysis projects 30 Create analysis projects from the Performance Analysis dashboard 31 Create analysis projects from the entity details page 31 Update charts in real-time (Real-Time Polling) 32 View the polled data for a plotted metric 32 Modify the time range for all charts 33 View more information for an entity 34 Share analysis projects 34 View your saved analysis projects 34 Delete analysis projects 34 Add a Performance Analysis Project to the menu 34 Troubleshooting Analysis Projects 35 References 37 Prepare SAM applications for integration 37 Relationship detection 39 page iii

5 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Relating nodes 39 Relating applications 39 page iv

6 Introduction to the DPA Integration Module Integrating SolarWinds Database Performance Analyzer with the SolarWinds Orion Platform provides visibility to issues affecting your database performance in the Orion Web Console and the rest of your monitoring information. You can view database instance information alongside other environmental factors to get a more comprehensive view of issues affecting users and your IT infrastructure. Integrating SolarWinds DPA information into your Orion Platform adds DPA-specific resources that poll information directly from DPA and expands the information available in other resources. Information from DPA, such as database wait time, improve your ability to troubleshoot slow response times or pinpoint database instances that need more resources. There are two steps to set up the integration: 1. Install the Database Performance Analyzer Integration Module (DPAIM). 2. Set up the DPA Integration Module. After the integration set up is complete, the SolarWinds Orion server saves the relationships made between DPA database instances and nodes, and applications monitored by the Orion Platform. The Orion server uses a service account created during integration set up to poll the DPA server for information and uses the relationships stored in the Orion database to display the related node or application. The Orion server requests information from the DPA server on the SSL port 8124 and provides links to DPA in the Orion Web Console that open to more detailed information. Users are automatically logged in to DPA with the service account credentials unless they already have a session open to DPA. No data from the Orion server is displayed in DPA. Integrating adds a Databases section to the Orion Web Console to monitor your databases. The Databases Summary view is a dashboard displaying database performance across your organization, whether the databases are monitored in SolarWinds DPA or in an Orion Platform product. Integrated database information is most helpful when used with SolarWinds Server & Application Monitor. This guide draws on many examples assuming you installed SolarWinds SAM. page 1

7 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Architecture of the DPA Integration Module page 2

8 DPA and SAM integration Integrating DPA with SolarWinds Server & Application Monitor (SAM) provides specific features only available when DPA and SAM are integrated. You can create two types of relationships between applications monitored by SAM and database instances monitored by DPA: A SAM application and a DPA database instance are monitoring the same application. A SAM application queries a DPA database instance. The first relationship type adds a DB Performance tab to the Application Details view for quick access to DPA resources. The second relationship type populates data to the following resources: Applications Using All My Databases This resource displays all applications monitored by SAM that query database instances monitored by all your DPA servers. Applications Using My Databases This resource displays the applications monitored by SAM that query database instances monitored by the selected DPA server. page 3

9 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Applications Using This Database This resource is on the Database Instances view. It tells you which applications are querying this database instance. Database Response Time (Client) This resource is on the Application views for applications that query databases monitored by DPA. Click a client application in the "Applications Using..." resources to access these views. For example, in the image above, click Microsoft IIS. The Database Response Time (Client) resource tells you how long your application is waiting on the database and why. The histogram breaks down the amount of time your application waited into discreet wait types, which identify what the database was doing. It often identifies resource contention. The icon next to each wait type provides a description of what this wait type means, common solutions, and the role within your organization most capable of this work. page 4

10 page 5

11 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE DPA and SRM integration Integrating DPA 11.0 and later with SolarWinds Storage Resource Monitor (SRM) 6.4 and later provides specific features only available when DPA and SRM are integrated. You can see contextually relevant information on storage objects related to databases monitored by DPA, and correlate storage health and performance with the databases mapped to the storage objects. After you define relationships between database instances and storage objects, click My Dashboards > Databases > DB Storage Summary. DPA and SRM integration populates data to the following resources: Storage Used By All Databases This resource displays all storage objects monitored by SRM related to database instances monitored by all your DPA servers. Storage Objects By Performance Risk This resource displays storage objects monitored by SRM where the related database instances contain one or more warnings or critical issues that may affect performance. page 6

12 Storage Objects By Capacity Risk This resource displays storage objects monitored by SRM where the related database instances contain one or more warnings or critical issues that may affect capacity. page 7

13 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Storage Used By This Database This resource is on the DB Storage tab of the Database Instance view. It tells you which storage objects are mapped to this database instance. page 8

14 IOPS Performance Per LUN This resource provides a chart comparing input/output operations per second (IOPS) for the current LUN with the other LUNs in the same storage pool. page 9

15 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Latency Performance Per LUN This resource charts the latency for the current LUN compared with the other LUNs in the same storage pool. page 10

16 Azure SQL support When you are using DPA to monitor Azure SQL databases, the following resources provide data about sessions, storage, and resource usage. Azure SQL DB Performance Statistics from Database Performance Analyzer For Azure SQL database instances, this resource displays information from SolarWinds DPA about the available DTUs (Database Transaction Units) and other resources being used. A DTU represents a combination of CPU, memory, data I/O and transaction log I/O. Microsoft places limits on these resources based on what service tier a database is in. When a database exceeds its limit for any resource, Microsoft restricts throughput, which slows performance. page 11

17 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Storage Statistics from Database Performance Analyzer For Azure SQL database instances, this resource displays storage statistics from SolarWinds DPA. Session Statistics from Database Performance Analyzer This resource displays the current status of sessions from SolarWinds DPA. page 12

18 page 13

19 Integrate DPA with Orion Platform products You can integrate any Orion Platform product with multiple instances of SolarWinds DPA. The DPA integration provides visibility into the performance metrics and suggested solutions that DPA provides. You cannot make changes to a database instance monitored by SolarWinds DPA from the SolarWinds Orion server. Integrate DPA and Orion Platform products 1. Check the Requirements for the DPA Integration Module. 2. Install the DPA Integration Module on your SolarWinds Orion server: DPAIM is automatically installed with SolarWinds SAM and later. If you have SAM, continue with the next step. To install SAM, use the SolarWinds Orion Installer. DPAIM is automatically installed with SAM, but is not included in the list of products. To install DPAIM without SAM, use the DPAIM stand-alone installer. You can install DPAIM alone or with other Orion Platform products. 3. Set up the DPA Integration Module. 4. Establish relationships between databases, applications, and storage objects. Requirements for the DPA Integration Module SolarWinds DPA and Orion Platform integration requires SolarWinds Database Performance Analyzer11.1 to be installed. SolarWinds recommends you install SolarWinds DPA and your SolarWinds Orion server on separate computers with separate databases. While SolarWinds SAM and SolarWinds DPA can integrate without extra configuration, you can take steps to relate SolarWinds DPA database instances to SolarWinds SAM applications more easily. See Prepare SAM applications for integration for more information. Port requirements In addition to the port requirements necessary for SolarWinds DPA and any other Orion Platform products, integration requires the following ports: page 14

20 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE DPA server PORT PROTOCOL SERVICE OR PROCESS DIRECTION ENCRYPTION DESCRIPTION 443 TCP (HTTPS) Windows: Inbound TLS 1.0 This is the default port (cloud) or 8124 (onpremises) Ignite PI Service Linux: Outbound TLS 1.1 TLS 1.2 number of your DPA website and jswis proxy. This port must be open to java/tomcat receive data from the SolarWinds Orion server. Orion server PORT PROTOCOL SERVICE OR PROCESS DIRECTION DESCRIPTION TCP SolarWinds Information Service TCP SolarWinds Information Service SolarWinds Orion Module Engine TCP SolarWinds Information Service Inbound Outbound Inbound Outbound Inbound Outbound This port must be open to access the SolarWinds Information Service API (notifications). This port must be open for all Orion Platform product traffic. This port must be open to access the SolarWinds Information Service API. Browser requirements Microsoft Edge Microsoft Internet Explorer 11 Do not use IE compatibility view. It may cause SolarWinds DPA to function incorrectly. Mozilla Firefox: latest stable version Google Chrome: latest stable version page 15

21 Next steps If necessary, install DPAIM: DPAIM is automatically installed with SolarWinds SAM and later. To install DPAIM without SAM, use the DPAIM stand-alone installer. When DPAIM is installed, set up the integration. Set up the DPA Integration Module You need the following information to integrate SolarWinds DPA with the Orion Platform: DPA server host name or IP address DPA port number DPA administrator credentials Orion server host name or IP address DPA server display name Set up the Integration Module in Settings 1. Log in as an administrator. Non-administrator accounts cannot view the Manage DPA Servers page. 2. Click Settings > All Settings. 3. Under Product Specific Settings, click Database Performance Analyzer. 4. Click Manage DPA Servers. 5. Click Add DPA Server. 6. Enter the required information, and click Test Connection. If the test fails and a new field for the SolarWinds Orion server address displays, enter your SolarWinds Orion server address using the fully qualified domain name or IP address. 7. Click Integrate. What happens during the integration setup? 1. The Orion server tests the connection and credentials to ensure it can communicate with the SolarWinds DPA server. 2. The Orion server uses the DPA administrator credentials to create service accounts on the DPA server, which are then saved to the Orion server. 3. The Orion server tests the connection and credentials again, and enables single sign-on. 4. The Orion server sets up federation so it can retrieve information from the SolarWinds Orion database and the DPA repository database. 5. The Orion server creates relationships between nodes, applications, and database instances from SolarWinds DPA. page 16

22 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE The service account is used when the SolarWinds Orion server queries the SolarWinds DPA server for information. Manage relationships to database instances, applications, and storage objects After you set up the SolarWinds DPA integration, the Orion Platform automatically creates relationships between nodes and applications in the SolarWinds Orion server and the database instances monitored by the SolarWinds DPA server. For SRM integration, you must manually create the relationships between database instances and storage objects. See the Access Relationship Management section below for instructions. The Orion Platform can integrate with multiple instances of SolarWinds DPA. After relationships are created between SolarWinds Orion objects and SolarWinds DPA database instances, the Orion Web Console displays information from both systems in the same resources and views. If you integrate with a DPA server that has Central Server mode enabled, you must integrate with its remote DPA servers manually to see their data in the Orion Web Console. The Orion Platform retrieves database instance information from SolarWinds DPA and attempts to build relationships between the SolarWinds DPA database instances and SolarWinds Orion nodes and applications based on the following criteria: IP addresses Host names SolarWinds SAM application templates Settings specific to database instances, such as instance name, SID, or port number You can modify relationships after integrating a DPA server. All relationships are deleted if you remove the integration. For more information about how the wizard relates objects and database instances, see Relationship detection. Database instances must exist in SolarWinds DPA before relationships can be created. Database refers to the database server, and all applications that ask the database server for information are clients. Access Relationship Management 1. Click Settings > All Settings. 2. Under Product Specific Settings, click Database Performance Analyzer. 3. Click Manage Relationships. page 17

23 Database Instances tab You can define, edit, or delete relationships using the Actions column. Click Add DPA Database Instance to open SolarWinds DPA and register a new monitored database instance. Client Applications tab You can edit or unlink relationships using the Actions column. Click Define New Relationship to relate an application from an Orion node in a client role to one or more database instances. Storage Objects tab You can edit or unlink relationships using the Actions column. Click Define New Relationship to relate database instances to storage objects (LUNs only). Discovery Central Discovery Central, available in Settings, provides a centralized overview of the types and number of network objects you are monitoring with your currently installed Orion platform products. The Database Performance Analyzer Integration section displays the number of available database instances mapped to SolarWinds Orion objects. Click Manage DPA Servers to integrate the server with one or more DPA servers. Click Manage Relationships to create relationships between nodes, applications, and database instances. page 18

24 DPA Integration Module After you have integrated DPA with the Orion Platform, you can view information from DPA in the Orion Web Console. Click My Dashboards > Databases > Databases Summary. If you integrated multiple DPA servers, the Databases Summary view displays resources that gather information from all of the servers. If you integrated one DPA server, the Databases Summary view displays resources with information from that server. Review the resources and in addition to critical issues or warnings, look for anything that looks out of the ordinary. For example, in the Instances with the Highest Wait Time resource, are there any bars or bar segments that are out of proportion with the others? If so, point to the segment for additional information, and click the instance below the chart to drill down and investigate further. Check the Advisors from Databases with the Highest Wait Time resource. Messages are automatically displayed in descending order by time stamp. You can sort the messages by severity, for example, only displaying Critical warnings. Point to the message for more information. Click the message to open SolarWinds DPA for further analysis. In the Greatest Upward Wait Time Trends resource, look for line segments that show extreme upward trends. Point to the line segment for more information, and click the instance below the chart to drill down and investigate further. The Advisors resource displays query issues that may not be urgent, but could become a problem later. The (All) Database Instances resource displays the list of database instances, with items that have critical issues or warnings on top. Click a database instance to see the Database Instance Details page. There you can see statistics from DPA, advisors, response time, the Mini-AppStack resource, and more. Click an application instance to see the DB Performance tab in the Application Details view. There you can see the same resources from the corresponding Database Instance Details page. DPA alerting in the Orion Platform In the Orion Platform, you can create alerts based on database instances monitored by DPA. In those alerts, you can set trigger conditions based on properties of the database instances. You receive a notification when the alert is triggered. page 19

25 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE You can filter the scope of DPA alerts based on: Database Instance Database Instance ID Monitor Status Overall Alarm Level Status Type You can trigger DPA alerts based on: Database Instance ID Monitor Status Overall Alarm Level Status Type Alert example This example shows how to create an alert when a certain database instance reaches a critical status. 1. Click Alerts & Activity > Alerts. 2. Click Manage Alerts. 3. Click Add New Alert. 4. Process to the second step of the Add New Alert wizard: Trigger Condition. 5. Select Database Instance in the I want to alert on list. The scope of alert 1. For the scope of the alert, select Only following set of objects. 2. Under All objects where, select Instance in the Select field list. 3. Click Select Objects. page 20

26 4. Select a database instance, and click Select. The actual trigger condition 1. Under Trigger alert when, click Browse All Fields in the Select field list. 2. Click Database Instance in the list on the left. 3. Select Status in the list on the right, and click Select. 4. Select Critical in the last list on the right. 5. Continue with the Add New Alert wizard. DPA reporting in the Orion Platform You can select DPA resources when creating a report in the Orion Platform. 1. Click Reports > All Reports. 2. Click Manage Reports. 3. Click Create New Report. 4. In the Group By list, select Feature. 5. Select Databases in the list of features. 6. Select a DPA resource, and click Select and Continue. 7. Select the objects to report on, and click Add to Layout. 8. Continue with the Add Report wizard. page 21

27 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Database instances in the AppStack environment SolarWinds SAM provides an Application Stack (or AppStack) with an interactive visual map that displays a detailed view of your environment. This map helps you identify the root cause of performance and availability issues. SolarWinds DPA includes a category called Database Instances in the AppStack environment. Assess database instances in the AppStack Use AppStack to assess the overall health of your database instances and to troubleshoot specific and related problems. page 22

28 1. Click My Dashboards > Home > Environment. 2. Expand the Database Instances category. The objects listed first are the highest priority. 3. Click an object to highlight related objects and gray out unrelated objects. 4. Click Spotlight to remove unrelated objects. This image shows a relationship between the database instance and an application: page 23

29 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE 5. To investigate further, click the selected object. 6. The selected object opens to the relevant Database Instance Details page. Mini-AppStack resource The AppStack view is also available at the database instance level, and only shows the relationships for that instance. This view is called the Mini-AppStack. 1. Click My Dashboards > Databases > Databases Summary. 2. Under All Database Instances, click the name of an instance. 3. On the Database Instance Details page, locate the AppStack Environment resource. Customize a DPAIM view and apply limitations View limitations restrict the information available for a specific view. 1. Click My Dashboards > Databases > Databases Summary. 2. Click Customize Page in the upper right. 3. To change the title of the page, edit the Name field, and then click Update. 4. To add a subview that can be accessed from tabs on the left: a. Select the Enable left navigation check box. b. Click Add Tab. c. Enter a name in the Tab Name field. d. Click Browse next to Tab Icon, and select an icon for this tab. e. Click Update. f. You can add more tabs, or continue. 5. To change the width of a column, enter the width in pixels in the Width field beneath the column. 6. To add a column, click Add New Column. page 24

30 7. To add a resource, repeat the following steps for each resource: a. Click + next to the column in which you want to add a resource. b. Select the resources to add, and click Add Selected Resources. 8. Use the icons next to each column to delete, clone, or move the selected resources. 9. To cycle the web console view through its database instance monitoring resources for continually updated and shared viewing, select Enable NOC view mode. 10. Click Preview to view your configuration in a new window. 11. Click Done. Restrict access by applying view limitations View limitations restrict the information available in a view for specific objects or database instances. 1. Log in to the Orion Web Console as an administrator. 2. Click My Dashboards > Databases > Databases Summary. 3. Click Customize Page in the upper right. 4. Under View Limitations, click Edit. 5. Scroll to the bottom of the list, and select a limitation type for the view. Integrating SolarWinds DPA and an Orion Platform product grants you the following additional view limitation types: Single Database Instance Group of Database Instances Database Instance Name Pattern 6. Click Continue. 7. Select a single database instance, group of database instances, or enter a name pattern. 8. Click Submit. DPAIM account limitations Account limitations restrict the information available for a specific user. Integrating SolarWinds DPA and an Orion Platform product grants you the following additional account limitations: Single Database Instance Group of Database Instances Database Instance Name Pattern page 25

31 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Restrict access by applying user account limitations 1. Log in to the Orion Web Console as an administrator. 2. Click Settings > All Settings. 3. Under User Accounts, click Manage Accounts. 4. Edit an individual or group account. a. Click Add Limitation in the Account Limitations section. b. Select the type of limitation to apply, and click Continue. c. Define the limitation, and click Submit. The limitation will be added to the Edit Account page. 5. Click Submit. When the user logs back in, the account respects the limitations applied to it. page 26

32 Troubleshooting DPAIM issues ISSUE RESOLUTION Cannot find or connect to the SolarWinds DPA server. Cannot find the Databases dashboard. A relationship was not created automatically when a node or application corresponds to a database instance. Access denied error when navigating to SolarWinds DPA from another Orion Platform product. No data is available on SolarWinds DPA-specific resources. Response time from the Orion Web Console to the DPA server takes Make sure the SolarWinds DPA server is running and accessible from the SolarWinds Orion server. Use the fully qualified domain or IP address of the SolarWinds DPA server. Ensure that the correct ports are open between the two computers. See Requirements for the DPA Integration Module for port information. 1. Click Settings > All Settings. 2. Under Customize Navigation & Look, click Customize Menu Bars. 3. Make sure that Databases_TabMenu is present, and that it contains Databases Summary. Make sure the host name or IP address of the database instance in SolarWinds DPA corresponds with the host name or IP address of the node or application in the Orion Platform product. Make sure the application monitor is working correctly in SolarWinds SAM and is monitoring the correct database instance. For more information, see Prepare SAM applications for integration. You must log in to SolarWinds DPA with your SolarWinds DPA credentials. Make sure the SolarWinds DPA server is running and accessible from the SolarWinds Orion server. No data may be available for that time period. Verify that the information exists in SolarWinds DPA. Verify your integration settings are correct. Ping from the Orion server to the DPA server. page 27

33 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE ISSUE RESOLUTION longer than five seconds. Check the firewall settings on each sever. o o Ports 80, 17776, 17777, and opened on the Orion server. Ports 8123 and 8124 on the DPA server. Check if the Ignite PI service is running on the DPA server. A red error message displays in the DPAIM. There may be an issue with your service accounts. Try removing the integration, and integrate again. You will lose all of your custom relationships between DPA and the Orion Platform. An unexpected error occurred. Contact SolarWinds support. No data is available for the database instance, or it does not appear to be monitored correctly. There may be an issue with your license. Check your licenses on the DPA server. Monitoring stopped in DPA. You have recently registered DB instances in DPA and there is no data yet. Allow time for DPA to poll data. There may be an issue with your Orion limitations. o o Check the account limitations for the affected user. Check the view limitations for the affected page. The Orion Platform displays sample data instead of real data. Integration is not established yet. See Set up the DPA Integration Module for more information. page 28

34 Troubleshooting environmental issues with Performance Analysis dashboards Create analysis projects with the Performance Analysis (PerfStack ) dashboard. Analysis projects visually correlate time series data, both historical and current, from multiple SolarWinds products and entity types in a single view. This allows you to: Troubleshoot issues in real-time. Create ad-hoc reports. Identify root causes of intermittent issues. Make data-driven decisions on infrastructure changes. Drag and drop performance metrics, events, and log data from multiple device types to a chart to perform deep analysis of what was going on in your environment when the issue occurred, including real-time polling for issues you're experiencing now. You can mix and match metrics from data collected across multiple SolarWinds products for both broad and in-depth insight to your infrastructure. For example, you could identify an issue in your application that causes disk I/O to spike and slowdowns if you collect SRM and SAM data. After your project is built, share the troubleshooting project with other members of your team for remediation. Compatible SolarWinds products Performance Analysis is most useful in correlating performance data when multiple SolarWinds products are installed. page 29

35 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE Correlate data from the following SolarWinds products: NPM 12.1 or later SAM 6.4 or later VIM 7.1 or later (VMAN integrated with the Orion Platform) NTA or later SRM 6.4 or later WPM or later EOC 2.0 or later NCM 7.7 or later (Configuration changes) VNQM or later (IPSLA operations) DPAIM 11.1 or later (DPA integrated with the Orion Platform) If you have at least one of these products installed together on the same server, you can access Performance Analysis dashboards. However, you may not be able to use all collected metrics if you pull data from older product versions. Some data are either not available or partially available in the Performance Analysis dashboard, such as data from the following: NetPath For a more complete list, see SolarWinds KB MT Create analysis projects The entities and metrics you can add to your analysis project depends on the SolarWinds products installed on your Orion server. Metrics marked with a rocket ship can collect real-time metrics. The data line may not fully extend to the right of the chart because it is based on the last polling time. Depending on your account limitations, you may not have access to all available data, metrics, or entities. However, all users can create Performance Analysis troubleshooting projects. page 30

36 Create analysis projects from the Performance Analysis dashboard 1. Click My Dashboards > Home > Performance Analysis. If you customize your dashboards, Performance Analysis might not be in the menu bar. Click Settings > All Settings > User Accounts > Edit and note what you use for HomeTab Menu bar. Click My Dashboards > Configure, and add Performance Analysis to the menu bar you used in HomeTab Menu bar. 2. Add entities. You can add a key entity and then add all other related entities. Hover over the entity in the metric palette and click the Add related icon. 3. Select an entity and choose metrics to drag to the dashboard. You can also drag and drop an entity directly to the charts. Create analysis projects from the entity details page Open an analysis project directly from the manage resource on your details page. This opens a project with relevant metrics from the entity already charted. For example, key metrics for node entities include: Average CPU Load Aerage Percent Memory Used Average Response Time Alerts Events Status Metrics that are not collected for an entity are not added. 1. Open the details page to an entity. 2. Click Performance Analyzer on the Management resource. You can add more metrics or metrics from related entities. page 31

37 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE This is supported for nodes, interfaces, IPSLA operations, clusters, datastores, hosts, VMs, LUNs, SRM pools, storage arrays, volumes, cloud instances, and SAM applications. Update charts in real-time (Real-Time Polling) Metrics with rocket ships next to them can utilize high frequency polling, one second apart, to update their charts. You can have both real-time metrics and regular metrics in your project. You can only have 10 realtime pollable metrics in your project. If you have 11, Real-Time Polling cannot start. Your project has a 10 minute window of real-time metrics. You may not have the option to poll entities in real-time. This option is controlled through individual account settings and is based on the version of Orion Platform your installation runs on. Orion Platform version includes this option. EOC installations do not have this option. You can poll up to 30 unique metrics across all user accounts in real-time. After this limit is reached, a warning message displays. When you stop Real-Time Polling, the metrics will continue to poll at the accelerated pace for two minutes before stopping. Real-Time Polling does not affect normal polling intervals. Click Start Real-Time Polling in the toolbar. All real-time enabled metrics in your analysis dashboard begin to poll the entities approximately every second. When the rocket ship icon flashes, Real-Time Polling has started. The icon stops flashing when data from the first poll is returned. View the polled data for a plotted metric This is available for Syslog, SNMP Traps, Events, Alerts, and Configuration changes on installations running on Orion Platform version Click and drag a selection on a chart, and click on the icon with the magnifying glass. page 32

38 The Data Explorer tab opens with the data that for the chart within the time frame you select. Use the Filters menu or the search bar to further reduce the visible data. Modify the time range for all charts You can set absolute, relative, or custom time ranges simultaneously across all charts in your troubleshooting project at the top of the dashboard. Click and drag to select a time range on a chart and zoom in or out using the hover menu. Click the X button to cancel the selection and return focus to the entire chart area. page 33

39 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE View more information for an entity Open the entity details page directly from the analysis project to view more information, such as MAC addresses or model numbers. Hover over the entity in the metric palette and click the link icon. Share analysis projects Click the Share button in your analysis dashboard to copy the project's URL to your clipboard. Share the URL so others can: Use the projects as-is and have the same data to troubleshoot issues. Modify the project and sent the URL back to you. Save it to their own Performance Analysis dashboard by clicking More > Save As. Add the project to a menu bar. For example, you may use a troubleshooting project to identify the root cause of an issue you are experiencing and send the URL in a help desk ticket for a technician to view, or you may share it with members of your team to refine your diagnoses or use as a troubleshooting tool. You can send the URL to anyone with access to the Orion Web Console. When a person views the troubleshooting project, all node access limitations are applied. View your saved analysis projects Click Load at the top of the dashboard to open your most recently used projects, or search for your saved projects. You can only view projects that you have created or saved, and you cannot save a project with Real-Time Polling enabled. You must manually turn Real-Time Polling on when loading a project. Delete analysis projects Click More > Delete to remove a project. You can only delete projects you have created. If a user creates a project and is removed from the SolarWinds user list, the projects that user saved are not removed from the server. If you delete a troubleshooting project that you have shared with others, you are only deleting your copy. Add a Performance Analysis Project to the menu Create a link directly to frequently used PerfStack analysis projects directly in your global navigation. View and account limitations apply to the project. 1. In your analysis project, click Share. The project's URL is automatically copied to your clipboard. 2. Click My Dashboards > Configure. 3. Click Edit on the menu bar you want to add the project to. page 34

40 4. Click Add under Available items. 5. Enter the name for the project you want to display in the menu. 6. Enter the URL copied from the analysis project, and click OK. 7. Move the new menu item to the Selected items column, and click Submit. The menu has a link to the Performance Analysis project. Click on the full-screen you can use in NOCs. button on saved projects to have a non-interactive, full-screen view that Troubleshooting Analysis Projects I do not see all the data I expect The collected data depends on the products you install and how they are configured. For example, you cannot display storage I/O data without installing and configuring SRM. You may not have access to the data. The data displayed depends on your account limitations. The entities may not have data during the time period you view. For example, a node under maintenance does not have data during that time frame because the node is not polled. You may be examining a time before the node was added. The data may not exist in the database. I do not see key entities The Performance Analysis dashboard respects account limitations. If your account is restricted from viewing certain entities or nodes, you cannot view the data in the Performance Analysis dashboard. Not all metrics I add are charted or data does not display correctly after I add more metrics This is usually due to browser limitations. Changes to the Performance Analysis dashboards are reflected in the URL. If you have a large amount of data, the URL may exceed the character limit for URLs in your particular browser. Save the troubleshooting project to compress the URL and continue to edit it. Some entities do not have metrics Metrics without data do not display in the metric palette. Some metrics do not line up or change when I expand or contract the time frame We use up to 240 data points to create the charts. On larger time frames, the data can be slightly distorted due to how many data points are used to create the chart. Additionally, data points are averaged and become more granular as you contract the time frame. page 35

41 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE The charts include different information when I share them The person looking at the shared chart may have account limitations applied or have different account limitations. Real-Time Polling does not work The node may be down, or the underlying polling method, such as SNMP, may be unresponsive. page 36

42 References This section provides reference information for the integration between SolarWinds DPA and the Orion Platform. Prepare SAM applications for integration The Database Performance Analyzer Integration Module looks for database instances to relate to each other for the following application templates: AppInsight for SQL SQL Server Performance (SQL) SQL Server Performance (WMI) SQL Server 2012 Performance (SQL) SQL Server 2012 Performance (WMI) Oracle Database Sybase ASE IBM DB2 MySQL MySQL and later (Windows) MySQL and later (Linux/UNIX) MySQL and earlier (Windows) MySQL and earlier (Linux/UNIX) MySQL Replication (Windows) MySQL Replication (Linux/UNIX) You can help successfully integrate more database instances by modifying some of your applications. These steps assume you assigned applications to nodes and all components use the correct credentials and connection settings. AppInsight for SQL To ensure that all component monitors use the correct credentials and connection settings: 1. Edit the application monitor, and select all component monitors. 2. Click Assign Credentials, and make sure that the correct credentials are used. 3. With all of the components still connected, click Multi Edit. 4. This step only applies to the SQL Server application templates: enter the database instance name. page 37

43 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE SQL Server Performance (SQL) 1. Edit the application monitor, and open the settings for the User Connections component monitor. 2. Override the SQL Server Instance property with the instance name, or leave it blank. SQL Server Performance (WMI) 1. Edit the application monitor, and open the settings for the Buffer Manager: Buffer cache hit ratio component monitor. 2. Override the Instance property with the instance name, or leave it blank. SQL Server 2012 Performance (SQL) 1. Edit the application monitor, and open the settings for the User Connections component monitor. 2. Override the SQL Server Instance property with the instance name, or leave it blank. SQL Server 2012 Performance (WMI) 1. Edit the application monitor, and open the settings for the Buffer Manager: Buffer cache hit ratio component monitor. 2. Override the Instance property with the instance name, or leave it blank. Oracle Database 1. Edit the application monitor, and open the settings for the Available free space (MB) component monitor. 2. Set the Destination Point Type property to SERVICE_NAME or SID, according to the monitored Oracle database. 3. Override the Destination Point Name property with the service name or SID. Sybase ASE 1. Edit the application monitor, and open the settings for the Transactions/sec component monitor. 2. Override the Connection String property with the connection string for the Sybase database. IBM DB2 1. Edit the application monitor, and open the settings for first the Database Used Space (MB) component monitor. 2. Override the Connection String property with the connection string for the DB2 database. MySQL 1. Edit the application monitor, and open the settings for first the Total Memory Used (MB) component monitor. 2. Override the Connection String property with the connection string for the MySQL database. page 38

44 MySQL Replication 1. Edit the application monitor, and open the settings for first the Slave Replication Status component monitor. 2. Override the Script Arguments property with: Windows: C:\Program Files\MySQL\MySQL Server 5.6\bin\mysql.exe,root,your_password Linux: /usr/bin/mysql root your_password Relationship detection When you integrate, the Orion Platform retrieves information from SolarWinds DPA and attempts to create relationships between SolarWinds DPA database instances and SolarWinds Orion nodes and applications. Relating nodes Database instances and nodes are related by matching IP addresses or host names. For IP address matching, the IPAddress property of the node is compared to the IP or Host property of the database instance. The database instance name can also be included in the IPAddress property, such as /dbi_instance. For host name matching, the SysName and DNS properties of the node are compared to the Host property of the database instance. The database instance name can also be included in these properties, such as lab/dbi_instance. If there are multiple nodes with the same IP address or host name, nodes monitored by an agent are removed from the potential relationships list. If there are multiple nodes remaining, you are prompted to choose a node on the relationship management page. Relating applications After nodes are related to database instances, the Orion Platform finds the supported SAM database applications associated with each node. Application matches are refined further with different matching techniques based on the type of application. AppInsight for SQL and multiple template-based applications are supported. AppInsight uses database instance name matching. Template-based applications match based on the database instance name and component settings. AppInsight for SQL If a database instance name in SolarWinds DPA matches exactly with a database instance name in AppInsight for SQL, that relationship is mapped. If a database instance name in SolarWinds DPA matches with a database instance name preceded by the default names for SQL instances, that relationship is also mapped. page 39

45 ADMINISTRATOR GUIDE: DATABASE PERFORMANCE ANALYZER INTEGRATION MODULE SQL Server Performance Relating SolarWinds DPA database instances to database instances monitored by a SQL Server Performance application uses the same database instance name matching as AppInsight for SQL. The different templates also use the following components to create matches: SQL Server Performance (SQL) - User Connections SQL Server Performance (WMI) - Buffer Manager: Buffer cache hit ratio SQL Server 2012 Performance (SQL) - User Connections SQL Server 2012 Performance (WMI) - Buffer Manager: Buffer cache hit ratio If a component is not set, the default template setting is used. Oracle If the DestinationPointType or DestinationPointName component matches the SolarWinds DPA database instance SID or ServiceName property, a match is made. Sybase, MySQL, and IBM DB2 The ports are extracted from the connection strings and compared. page 40