On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
16 rates
To monitor Sybase with Database Visibility, you must be running version 15 or newer. 

Connection Details

FieldDescription
Database TypeThe database type that you want to monitor.
Database AgentThe Database Agent that manages the collector.
NameThe name you want to identify the collector by.
Hostname 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:sybase:Tds:. You can also specify a custom connection string, which is useful for setting custom authentication options.
UsernameThe name of the user who is connecting to and monitoring the database through the Database Agent. The user should have the permissions described in User Permissions for Sybase.
PasswordThe password of the user who is connecting to and monitoring the database through the Database Agent.
Sub-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 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.
CyberArkClick to enable CyberArk for database username and password. When CyberArk is enabled, information about Application, Safe, Folder, and Object is required to fetch the username and password for your database. To use CyberArk with Database Visibility, you must download the JavaPasswordSDK.jar file from the CyberArk web site and rename the file to cyberark-sdk-9.5.jar. Then, you must copy the JAR file to the lib directory of the database agent zip file. 
Exclude DatabasesThe databases that you want to exclude, separated by commas
Logging EnabledClick to enable verbose mode logging, which logs all communications between the Controller and the Collector. Enable only during troubleshooting because logging consumes a lot of disk space. If you have enabled logging, you can click the logging icon in the Log column of the Collector Administration window to view the log file. The log files are located in the <db_agent_home>\agent directory and have the format <CollectorName>_out.log and <CollectorName>_err.log.

User Permissions for Sybase

For complete AppDynamics Database Visibility functionality, the monitoring user requires the permissions listed in the table below.

Permission typePermission
Role permission
  • sa_role
  • mon_role
Select permission
  • master.dbo.monWaitEventInfo
  • master.dbo.sysconfigures
  • master.dbo.sysmonitors
  • master.dbo.monProcess
  • master.dbo.monProcessLookup
  • master.dbo.monProcessSQLText
  • master.dbo.monProcessProcedures
Execute permission
  • sp_sysmon

 

To create a new dedicated user for AppDynamics Database Visibility, you can use following sample user creation script. Before running the script, change "password" to a more secure value.

exec  sp_addlogin  'DBMon_Agent_User', 'password', @defdb='master', @deflanguage='us_english', @fullname='DBMon_Agent_User monitoring account', @auth_mech = 'ANY'
go
exec  sp_locklogin  'DBMon_Agent_User', 'unlock'
go
exec  sp_role 'grant', 'mon_role', 'DBMon_Agent_User'
go

where DBMon_Agent_User is the user name under which you run the Database Visibility Agent.

 

Also, the following configuration parameters must be set to 1 (true) in order to monitor the Sybase ASE database with AppDynamics Database Visibility: "enable monitoring", "wait event timing", "SQL batch capture", and "object lockwait timing". You should also set "max SQL text monitored" to at least 8192 (8kB).

Here is an example of the commands required to configure these settings:

sp_configure "enable monitoring", 1
go
sp_configure "wait event timing", 1
go
sp_configure "SQL batch capture", 1
go
sp_configure "object lockwait timing", 1
go
sp_configure "max SQL text monitored", 8192
go

If the value for "max SQL text monitored" was previously less than 4096, then increasing this setting will require that you restart the Sybase ASE instance.

To monitor Sybase version 15.7 and later without the sa_role permission, run the following commands:

use sybsystemprocs
grant execute on sp_sysmon to mon_role

If you choose to monitor Sybase using sp_sysmon, you may encounter the following errors:

  • Thread utilization is incorrectly reported. View the official report here.
  • Timeslice error in mmap64 or mda_flush_iostats. View the official report here.
  • No labels