Database Administrator (DBA) report discovery
Discovery and Service Mapping uses the Patterns extension sections to provide a Database Administrator report (DBA report) for the Apache Cassandra, Microsoft SQL, MySQL, MongoDB, and Oracle databases. The extension sections for each DB pattern populate the related entries tables. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.
Request new or enhanced Patterns on the ServiceNow® Store
Visit the ServiceNow Store to view all the available updates and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Prerequisites
- Verify the plugins setup
- CMDB CI Class Models 1.49.0 (September 2023)
- Discovery and Service Mapping Patterns 1.8.0 (September 2023)
Verify the system properties are enabled
By default, the system properties for DBA reports are set to false. To enable the report collection, verify that the system properties value for each pattern is set to true.
Pattern System property Cassandra cassandra_dba_report_enabled MongoDB mongo_dba_report_enabled MSSQL DB On Windows mssql_dba_report_enabled My SQL server On Windows and Linux mysql_dba_report_enabled Oracle DB oracle_dba_report_enabled Verify the configuration of the credentials
For more information, see Applicative credentials.
| MongoDB execute command | Applicative credentials should have read access to run `“getSiblingDB (databaseName)”` |
| Apache Cassandra execute command | Discovery credentials should have read access to `“nodetool”` |
| MySQL tables and execute commands | Discovery credentials should have read access to:- `“information_schema.tables”` table - run `“show databases”`command |
| Microsoft SQL tables | Discovery credentials should have read access to the following tables:- master.sys.databases - sys.sysprocesses - sys.dm_os_sys_info - sys.dm_os_ring_buffers - msdb.dbo.backupset - master.dbo.sysdatabases - master..sysprocesses - msdb..sysjobactivity - sys.master_files - sys.dm_tran_session_transactions - sys.dm_os_sys_memory - sys.database_files |
| Oracle DB tables and execute commands | Discovery credentials should have read access to: - Run “lsnrctl services” and “sqlplus” commands - dba_data_files table - dba_segments table - v$database table - gv$instance table - dba_hist_osstat table - dba_hist_snapshot table - v$asm_disk table - v$asm_diskgroup table - dba_audit_session table - gv$session_longops table - gv$session table - gv$sqlarea table - gv$process table |
Verify that a Discovery schedule is configured
For more information, see create a discovery schedule
Data collected by the extension section of the Apache Cassandra pattern
Discovery populates the following data when running the Apache Cassandra pattern.
Note: See the Prerequisites section for important information about enabling the system property.
| Table name | Table label | Fields |
|---|---|---|
| cassandra\_health\_report | Cassandra Health Report | - database\_host - local\_write\_latency - read\_latency - snapshot\_used\_space - space\_used - table - keyspace - ci |
Data collected by the extension section of the MongoDB pattern
Discovery populates the following data when running the MongoDB pattern.
Note: See the Prerequisites section for important information about enabling the system property.
| Table name | Table label | Fields |
|---|---|---|
| mongo\_db\_statistics | Mongo DB Statistics | - database\_host - database\_name - fs\_total\_size - fs\_used\_size - scale\_factor - index\_size - index\_count - extents\_count - storage\_size - data\_size - average\_object\_size - objects\_count - collection\_count - view\_count - ci |
Data collected by the extension section of the MSSQL pattern
Discovery populates the following data when running the MSSQL pattern.
Note: See the Prerequisites section for important information about enabling the system property.
| Table name | Table label | Fields |
|---|---|---|
| ms\_sql\_db\_blocking\_info | MSSQL DB Blocking Info | - database\_host - database\_instance - definition - object\_name - blocking\_spid - spid - ci |
| ms\_sql\_db\_cpu\_util | MSSQL DB CPU Util | - database\_host - database\_instance - load\_date - other\_process\_cpu\_util - other\_process - system\_idle\_process - sql\_server\_cpu\_util - event\_time - server\_name - ci |
| ms\_sql\_db\_not\_backup | MSSQL DB Not BackUp | - database\_host - database\_instance - last\_backup\_date - database\_name - ci |
| ms\_sql\_db\_running\_job | MSSQL DB Running Job | - database\_host - database\_instance - login\_name - nt\_domain - cmd - hostname - name - status - open\_tran - Spid - last\_wait\_type - login\_time - ci |
| ms\_sql\_disk\_info | MSSQL DB Disks Info | - database\_host - database\_instance - percentage\_free\_space - volume\_free\_space - volume\_capacity - volume\_label - volume\_name - ci |
| ms\_sql\_files\_space | MSSQL DB Files Space | - database\_host - database\_instance - database\_name - free\_space\_mb - file\_size\_mb - file\_type - file\_logic\_name - ci |
| ms\_sql\_fregment\_info | MSSQL DB Fragmentation Info | - database\_host - database\_instance - index\_status - page\_count - avg\_frag - index\_name - object\_name - schema\_name - ci |
| ms\_sql\_last\_restart | MSSQL DB Last Restart | - database\_host - database\_instance - uptime\_in\_days - current\_date - last\_recycle - ci |
| ms\_sql\_long\_trans | MSSQL DB Long Transactions | - database\_host - database\_instance - blocked - sql - cmd - program\_name - hostname - login\_name - status - last\_batch - duration - login\_time - database\_name - user\_tran - trans\_id - spid - ci |
| ms\_sql\_memory\_info | MSSQL DB Memory Info | - database\_host - database\_instance - system\_memory\_state\_desc - percentage\_used - available\_page\_file\_mb - total\_page\_file\_mb - available\_physical\_memory\_mb - total\_physical\_memory\_mb - ci |
| ms\_sql\_temp\_files\_space | MSSQL DB Temp Files Space | - database\_host - database\_instance - percent\_full - available\_space\_mb - file\_physical\_name - file\_logic\_name - database\_name - ci |
Data collected by the extension section of the MySQL pattern
Discovery populates the following data when running the MySQL pattern.
Note: See the Prerequisites section for important information about enabling the system property.
| Table name | Table label | Fields |
|---|---|---|
| mysql\_table\_schemas | MySql Table Schemas | - database\_host - database\_instance - data\_index\_lengh - table\_schema - ci |
Data collected by the extension section of the Oracle DB pattern
Discovery populates the following data when running the Oracle DB pattern.
Note: See the Prerequisites section for important information about enabling the system property.
| Table name | Table label | Fields |
|---|---|---|
| oracle\_active\_session | Oracle Active Session | - database\_host - database\_instance - Key - sql\_id - program - module - action - status - last\_call\_et\_hrs - sid - spid - inst - ci |
| oracle\_asm\_info | Oracle, ASM Disk Info | - database\_host - database\_instance - used\_gb - free\_gb - total\_gb - state - block\_size - asm - ci |
| oracle\_asm\_nodes\_info | Oracle ASM Nodes Disk Info | - database\_host - database\_instance - redundancy - free\_gb - total\_gb - state - asm\_node - ci |
| oracle\_cpu\_usage | Oracle CPU Usage | - database\_host - database\_instance - idle - io - sys - nice - user - snapid - Inst - end\_time - begin\_time - ci |
| oracle\_inactive\_sessions | Oracle Inactive Sessions | - database\_host - database\_instance - key - status - spid - sid - program - Module - last\_call\_et\_hrs - inst - ci |
| oracle\_instance\_info | Oracle Instance Info | - database\_host - database\_instance - platform\_name - current\_scn - dbid - db\_unique\_name - log\_mode - db\_name - open\_mode - ci |
| oracle\_nodes\_info | Oracle Nodes Info | - database\_host - database\_instance - instance\_mode - instance\_state - instance\_role - instance\_status - instance\_version - hostname - instance\_name - ci |
| oracle\_table\_space | Oracle Table Space | - database\_host - database\_instance - used\_mb - free\_percent - free\_mb - tablespace - total\_mb - ci |
| oracle\_top\_10\_queries | Oracle Top 10 Queries | - database\_host - database\_instance - unique - status - sql\_id - spid - sid - program - Module - last\_call\_et\_hrs - ci |
Parent Topic:Database discovery