To monitor SAP HANA with Database Visibility, you must run:

  • SAP HANA >= 2.0 SPS 05 or >= QRC 3/2023
  • Database Agent >= 24.5
  • Controller >= 24.5

Prerequisite

Download the JDBC driver jar file from the SAP website or copy it from the HANA installation package. Then, rename the file to ngdbc-2.18.13.jar and copy the JAR file to the <db_agent_home>/lib directory.

Connection Details

SectionFieldDescription
Create New CollectorDatabase TypeThe database type that you want to monitor.
AgentThe Database Agent that manages the collector.
Collector NameThe name you want to identify the collector by.
Connection DetailsHostname or IP AddressThe hostname or IP address of the machine that your database is running on.
Listener PortThe TCP/IP address of the port on which your database communicates with the Database Agent
Custom JDBC Connection StringThe JDBC connection string generated by the database agent, for example, jdbc:mysql://. You can also specify a custom connection string, which is useful for setting custom authentication options.
Username and PasswordUsernameThe name of the user who is connecting to and monitoring the database through the Database Agent.
PasswordThe password of the user who is connecting to and monitoring the database through the Database Agent.
Advanced OptionsSub-Collectors

Click to monitor multiple database instances in a consolidated view, and aggregate metrics of multiple databases. To monitor a custom cluster, you can add the additional hostname or IP address, and port details for each sub-collector. You can add up to a total of 29 sub-collectors. Thereby, 30 databases can be monitored in a custom cluster. In addition to the licenses consumed by the main collector, each sub-collector consumes one or more licenses, depending on the database type.

Note

  • All connection parameters other than the hostname or IP address, and port details of the sub-collector are the same as the main collector. If you want to specify different parameters for the sub–collectors, while creating or editing the collector configuration, you can do that only via the Create Collector API.

  • You cannot convert a custom cluster collector to a standalone collector. If you want to monitor a standalone database, delete the entire custom cluster collector and create a fresh standalone collector. However, note that deleting the custom cluster collector will delete all its historical data.
Connection PropertiesClick to add a new JDBC connection property or edit an existing property for relational databases.
Exclude DatabasesThe databases that you want to exclude, separated by commas. 
Monitor Operating SystemSee Configure the Database Agent to Monitor Server Hardware.

User Permissions for SAP HANA

  1. Create a monitoring user:
    CREATE USER <username> PASSWORD <password>;
    CODE
  2. Grant permissions to the user to monitor the database:
    GRANT MONITORING TO <username>;
    CODE