48 KiB
Oracle by ODBC
Overview
The template is developed to monitor a single DBMS Oracle Database instance with ODBC and can monitor CDB or non-CDB installations.
Requirements
Zabbix version: 7.0 and higher.
Tested versions
This template has been tested on:
- Oracle Database 12c2, 18c, 19c
Configuration
Zabbix should be configured according to the instructions in the Templates out of the box section.
Setup
-
Create an Oracle DB user for monitoring:
In CDB installations it is possible to monitor tablespaces from CDB (container database) and all PDBs (pluggable databases). In such case, a common user is needed with the correct rights:
CREATE USER c##zabbix_mon IDENTIFIED BY <PASSWORD>; -- Grant access to the c##zabbix_mon user. ALTER USER c##zabbix_mon SET CONTAINER_DATA=ALL CONTAINER=CURRENT; GRANT CONNECT, CREATE SESSION TO c##zabbix_mon; GRANT SELECT_CATALOG_ROLE to c##zabbix_mon; GRANT SELECT ON v_$instance TO c##zabbix_mon; GRANT SELECT ON v_$database TO c##zabbix_mon; GRANT SELECT ON v_$sysmetric TO c##zabbix_mon; GRANT SELECT ON v_$system_parameter TO c##zabbix_mon; GRANT SELECT ON v_$session TO c##zabbix_mon; GRANT SELECT ON v_$recovery_file_dest TO c##zabbix_mon; GRANT SELECT ON v_$active_session_history TO c##zabbix_mon; GRANT SELECT ON v_$osstat TO c##zabbix_mon; GRANT SELECT ON v_$restore_point TO c##zabbix_mon; GRANT SELECT ON v_$process TO c##zabbix_mon; GRANT SELECT ON v_$datafile TO c##zabbix_mon; GRANT SELECT ON v_$pgastat TO c##zabbix_mon; GRANT SELECT ON v_$sgastat TO c##zabbix_mon; GRANT SELECT ON v_$log TO c##zabbix_mon; GRANT SELECT ON v_$archive_dest TO c##zabbix_mon; GRANT SELECT ON v_$asm_diskgroup TO c##zabbix_mon; GRANT SELECT ON sys.dba_data_files TO c##zabbix_mon; GRANT SELECT ON DBA_TABLESPACES TO c##zabbix_mon; GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO c##zabbix_mon; GRANT SELECT ON DBA_USERS TO c##zabbix_mon;
This is needed because the template uses
CDB_*
views to monitor tablespaces from CDB and different PDBs, and, therefore, the monitoring user needs access to the container data objects on all PDBs.However, if you wish to monitor only a single PDB or non-CDB instance, a local user is sufficient:
CREATE USER zabbix_mon IDENTIFIED BY <PASSWORD>; -- Grant access to the zabbix_mon user. GRANT CONNECT, CREATE SESSION TO zabbix_mon; GRANT SELECT_CATALOG_ROLE to zabbix_mon; GRANT SELECT ON v_$instance TO zabbix_mon; GRANT SELECT ON v_$database TO zabbix_mon; GRANT SELECT ON v_$sysmetric TO zabbix_mon; GRANT SELECT ON v_$system_parameter TO zabbix_mon; GRANT SELECT ON v_$session TO zabbix_mon; GRANT SELECT ON v_$recovery_file_dest TO zabbix_mon; GRANT SELECT ON v_$active_session_history TO zabbix_mon; GRANT SELECT ON v_$osstat TO zabbix_mon; GRANT SELECT ON v_$restore_point TO zabbix_mon; GRANT SELECT ON v_$process TO zabbix_mon; GRANT SELECT ON v_$datafile TO zabbix_mon; GRANT SELECT ON v_$pgastat TO zabbix_mon; GRANT SELECT ON v_$sgastat TO zabbix_mon; GRANT SELECT ON v_$log TO zabbix_mon; GRANT SELECT ON v_$archive_dest TO zabbix_mon; GRANT SELECT ON v_$asm_diskgroup TO zabbix_mon; GRANT SELECT ON sys.dba_data_files TO zabbix_mon; GRANT SELECT ON DBA_TABLESPACES TO zabbix_mon; GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO zabbix_mon; GRANT SELECT ON DBA_USERS TO zabbix_mon;
Note! Ensure that ODBC connects to Oracle with session parameter NLS_NUMERIC_CHARACTERS= '.,'. It is important for displaying the float numbers in Zabbix correctly.
-
Install the ODBC driver on Zabbix server or Zabbix proxy. See the Oracle documentation for instructions.
-
Configure Zabbix server or Zabbix proxy for the usage of Oracle Environment:
This step is required only when:
-
installing Oracle Instant Client with .rpm packages with version < 19.3 (if Instant Client is the only Oracle Software installed on Zabbix server or Zabbix proxy);
-
installing Oracle Instant Client manually with .zip files.
There are multiple ways of achieving this:
-
Using
LDCONFIG
utility (recommended option):To update the runtime link path, it is recommended to use the
LDCONFIG
utility, for example:# sh -c "echo /opt/oracle/instantclient_19_18 > /etc/ld.so.conf.d/oracle-instantclient.conf" # ldconfig
-
Using application configuration file:
An alternative solution is to export the required variables by editing or adding a new application configuration file:
-
/etc/sysconfig/zabbix-server # for server
-
/etc/sysconfig/zabbix-proxy # for proxy
And then, adding:
# Oracle Instant Client library LD_LIBRARY_PATH=/opt/oracle/instantclient_19_18:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
-
Keep in mind that the library paths will vary depending on your installation.
This is a minimal configuration example. Depending on the Oracle Instant Client version, required functionality and host operating system, a different set of additional packages might need to be installed. For more detailed configuration instructions, see the official Oracle Instant Client installation instructions for Linux.
-
-
Restart Zabbix server or Zabbix proxy.
-
Set the username and password in the host macros ({$ORACLE.USER} and {$ORACLE.PASSWORD}).
-
Set the {$ORACLE.DRIVER} and {$ORACLE.SERVICE} in the host macros.
-
{$ORACLE.DRIVER}
is a path to the driver location in OS. The ODBC driver file should be found in Instant Client directory and namedlibsqora.so.XX.Y
. -
{$ORACLE.SERVICE}
is a service name to which the host will connect to. The value in this macro is important as it determines if the connection is established to a non-CDB, CDB or PDB. If you wish to monitor tablespaces of all PDBs, you will need to set a service name that points to the CDB. Active service names can be seen from the instance running Oracle Database withlsnrctl status
.
Note! Make sure that the user created in step #1 is present on the specified service.
The "Service's TCP port state" item uses
{HOST.CONN}
and{$ORACLE.PORT}
macros to check the availability of the listener. -
Macros used
Name | Description | Default |
---|---|---|
{$ORACLE.DRIVER} | The Oracle driver path. For example: |
<Put path to oracle driver here> |
{$ORACLE.SERVICE} | Oracle Service Name. |
<Put oracle service name here> |
{$ORACLE.USER} | Oracle username. |
<Put your username here> |
{$ORACLE.PASSWORD} | The Oracle user's password. |
<Put your password here> |
{$ORACLE.PORT} | Oracle DB TCP port. |
1521 |
{$ORACLE.DBNAME.MATCHES} | This macro is used in database discovery. It can be overridden on host level or its linked template level. |
.* |
{$ORACLE.DBNAME.NOT_MATCHES} | This macro is used in database discovery. It can be overridden on host level or its linked template level. |
PDB\$SEED |
{$ORACLE.TABLESPACE.CONTAINER.MATCHES} | This macro is used in tablespace discovery. It can be overridden on host level or its linked template level. |
.* |
{$ORACLE.TABLESPACE.CONTAINER.NOT_MATCHES} | This macro is used in tablespace discovery. It can be overridden on host level or its linked template level. |
CHANGE_IF_NEEDED |
{$ORACLE.TABLESPACE.NAME.MATCHES} | This macro is used in tablespace discovery. It can be overridden on host level or its linked template level. |
.* |
{$ORACLE.TABLESPACE.NAME.NOT_MATCHES} | This macro is used in tablespace discovery. It can be overridden on host level or its linked template level. |
CHANGE_IF_NEEDED |
{$ORACLE.TBS.USED.PCT.MAX.WARN} | Warning severity alert threshold for the maximum percentage of tablespace usage (used bytes/allocated bytes) for a trigger expression. |
90 |
{$ORACLE.TBS.USED.PCT.MAX.HIGH} | High severity alert threshold for the maximum percentage of tablespace usage (used bytes/allocated bytes) for a trigger expression. |
95 |
{$ORACLE.TBS.UTIL.PCT.MAX.WARN} | Warning severity alert threshold for the maximum percentage of tablespace utilization (allocated bytes/max bytes) for a trigger expression. |
80 |
{$ORACLE.TBS.UTIL.PCT.MAX.HIGH} | High severity alert threshold for the maximum percentage of tablespace utilization (allocated bytes/max bytes) for a trigger expression. |
90 |
{$ORACLE.PROCESSES.MAX.WARN} | Alert threshold for the maximum percentage of active processes for a trigger expression. |
80 |
{$ORACLE.SESSIONS.MAX.WARN} | Alert threshold for the maximum percentage of active sessions for a trigger expression. |
80 |
{$ORACLE.DB.FILE.MAX.WARN} | The maximum percentage of used database files for a trigger expression. |
80 |
{$ORACLE.PGA.USE.MAX.WARN} | Alert threshold for the maximum percentage of the Program Global Area (PGA) usage for a trigger expression. |
90 |
{$ORACLE.SESSIONS.LOCK.MAX.WARN} | Alert threshold for the maximum percentage of locked sessions for a trigger expression. |
20 |
{$ORACLE.SESSION.LOCK.MAX.TIME} | The maximum duration of the session lock in seconds to count the session as a prolongedly locked query. |
600 |
{$ORACLE.SESSION.LONG.LOCK.MAX.WARN} | Alert threshold for the maximum number of the prolongedly locked sessions for a trigger expression. |
3 |
{$ORACLE.CONCURRENCY.MAX.WARN} | The maximum percentage of sessions concurrency usage for a trigger expression. |
80 |
{$ORACLE.REDO.MIN.WARN} | Alert threshold for the minimum number of REDO logs for a trigger expression. |
3 |
{$ORACLE.SHARED.FREE.MIN.WARN} | Alert threshold for the minimum percentage of free shared pool for a trigger expression. |
5 |
{$ORACLE.EXPIRE.PASSWORD.MIN.WARN} | The number of warning days before the password expires for a trigger expression. |
7 |
{$ORACLE.ASM.USED.PCT.MAX.WARN} | The maximum percentage of used ASM disk group for a warning trigger expression. |
90 |
{$ORACLE.ASM.USED.PCT.MAX.HIGH} | The maximum percentage of used Automatic Storage Management (ASM) disk group for a high trigger expression. |
95 |
Items
Name | Description | Type | Key and additional info |
---|---|---|---|
Oracle: Service's TCP port state | It checks the availability of Oracle on the TCP port. |
Zabbix agent | net.tcp.service[tcp,{HOST.CONN},{$ORACLE.PORT}] Preprocessing
|
Oracle: Number of LISTENER processes | The number of running LISTENER processes. |
Zabbix agent | proc.num[,,,"tnslsnr LISTENER"] Preprocessing
|
Oracle: Get instance state | The item gets its state of the current instance. |
Database monitor | db.odbc.get[get_instance_state,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Oracle: Version | The Oracle Server version. |
Dependent item | oracle.version Preprocessing
|
Oracle: Uptime | The Oracle instance uptime expressed in seconds. |
Dependent item | oracle.uptime Preprocessing
|
Oracle: Instance status | The status of the instance. |
Dependent item | oracle.instance_status Preprocessing
|
Oracle: Archiver state | The status of automatic archiving. |
Dependent item | oracle.archiver_state Preprocessing
|
Oracle: Instance name | The name of an instance. |
Dependent item | oracle.instance_name Preprocessing
|
Oracle: Instance hostname | The name of the host machine. |
Dependent item | oracle.instance_hostname Preprocessing
|
Oracle: Instance role | It indicates whether the instance is an active instance or an inactive secondary instance. |
Dependent item | oracle.instance.role Preprocessing
|
Oracle: Get system metrics | The item gets the values of the system metrics. |
Database monitor | db.odbc.get[get_system_metrics,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Oracle: Sessions limit | The user and system sessions. |
Dependent item | oracle.session_limit Preprocessing
|
Oracle: Datafiles limit | The maximum allowable number of datafiles. |
Dependent item | oracle.db_files_limit Preprocessing
|
Oracle: Processes limit | The maximum number of user processes. |
Dependent item | oracle.processes_limit Preprocessing
|
Oracle: Number of processes | Dependent item | oracle.processes_count Preprocessing
|
|
Oracle: Datafiles count | The current number of datafiles. |
Dependent item | oracle.db_files_count Preprocessing
|
Oracle: Buffer cache hit ratio | The ratio of buffer cache hits ((LogRead - PhyRead)/LogRead). |
Dependent item | oracle.buffer_cache_hit_ratio Preprocessing
|
Oracle: Cursor cache hit ratio | The ratio of cursor cache hits (CursorCacheHit/SoftParse). |
Dependent item | oracle.cursor_cache_hit_ratio Preprocessing
|
Oracle: Library cache hit ratio | The ratio of library cache hits (Hits/Pins). |
Dependent item | oracle.library_cache_hit_ratio Preprocessing
|
Oracle: Shared pool free % | Free memory of a shared pool expressed in %. |
Dependent item | oracle.shared_pool_free Preprocessing
|
Oracle: Physical reads per second | Reads per second. |
Dependent item | oracle.physical_reads_rate Preprocessing
|
Oracle: Physical writes per second | Writes per second. |
Dependent item | oracle.physical_writes_rate Preprocessing
|
Oracle: Physical reads bytes per second | Read bytes per second. |
Dependent item | oracle.physical_read_bytes_rate Preprocessing
|
Oracle: Physical writes bytes per second | Write bytes per second. |
Dependent item | oracle.physical_write_bytes_rate Preprocessing
|
Oracle: Enqueue timeouts per second | Enqueue timeouts per second. |
Dependent item | oracle.enqueue_timeouts_rate Preprocessing
|
Oracle: GC CR block received per second | The global cache (GC) and the consistent read (CR) block received per second. |
Dependent item | oracle.gc_cr_block_received_rate Preprocessing
|
Oracle: Global cache blocks corrupted | The number of blocks that encountered corruption or checksum failure during the interconnect. |
Dependent item | oracle.cache_blocks_corrupt Preprocessing
|
Oracle: Global cache blocks lost | The number of lost global cache blocks. |
Dependent item | oracle.cache_blocks_lost Preprocessing
|
Oracle: Logons per second | The number of logon attempts. |
Dependent item | oracle.logons_rate Preprocessing
|
Oracle: Average active sessions | The average active sessions at a point in time. The number of sessions that are either working or waiting. |
Dependent item | oracle.active_sessions Preprocessing
|
Oracle: Session count | The count of sessions. |
Dependent item | oracle.session_count Preprocessing
|
Oracle: Active user sessions | The number of active user sessions. |
Dependent item | oracle.session_active_user Preprocessing
|
Oracle: Active background sessions | The number of active background sessions. |
Dependent item | oracle.session_active_background Preprocessing
|
Oracle: Inactive user sessions | The number of inactive user sessions. |
Dependent item | oracle.session_inactive_user Preprocessing
|
Oracle: Sessions lock rate | The percentage of locked sessions. Locks are mechanisms that prevent destructive interaction between transactions accessing the same resource — either user objects, such as tables and rows or system objects not visible to users, such as shared data structures in memory and data dictionary rows. |
Dependent item | oracle.session_lock_rate Preprocessing
|
Oracle: Sessions locked over {$ORACLE.SESSION.LOCK.MAX.TIME}s | The count of the prolongedly locked sessions. (You can change the duration of maximum session lock in seconds for a query by {$ORACLE.SESSION.LOCK.MAX.TIME} macro. Default is 600 sec). |
Dependent item | oracle.session_long_time_locked Preprocessing
|
Oracle: Sessions concurrency | The percentage of concurrency. Concurrency is a DB behavior when different transactions request to change the same resource. In the case of modifying data transactions, it sequentially temporarily blocks the right to change the data, the rest of the transactions are waiting for the access. In the case when the access for the resource is locked for a long time, then the concurrency grows (like the transaction queue) and this often has an extremely negative impact on the performance. A high contention value does not indicate the root cause of the problem but is a signal to search for it. |
Dependent item | oracle.session_concurrency_rate Preprocessing
|
Oracle: User '{$ORACLE.USER}' expire password | The number of days before the password of Zabbix account expires. |
Dependent item | oracle.user_expire_password Preprocessing
|
Oracle: Active serial sessions | The number of active serial sessions. |
Dependent item | oracle.active_serial_sessions Preprocessing
|
Oracle: Active parallel sessions | The number of active parallel sessions. |
Dependent item | oracle.active_parallel_sessions Preprocessing
|
Oracle: Long table scans per second | The number of long table scans per second. A table is considered 'long' if the table is not cached and if its high-water mark is greater than five blocks. |
Dependent item | oracle.long_table_scans_rate Preprocessing
|
Oracle: SQL service response time | The Structured Query Language (SQL) service response time expressed in seconds. |
Dependent item | oracle.service_response_time Preprocessing
|
Oracle: User rollbacks per second | The number of times that users manually issue the ROLLBACK statement or an error occurred during the users' transactions. |
Dependent item | oracle.user_rollbacks_rate Preprocessing
|
Oracle: Total sorts per user call | The total sorts per user call. |
Dependent item | oracle.sorts_per_user_call Preprocessing
|
Oracle: Rows per sort | The average number of rows per sort for all types of sorts performed. |
Dependent item | oracle.rows_per_sort Preprocessing
|
Oracle: Disk sort per second | The number of sorts going to disk per second. |
Dependent item | oracle.disk_sorts Preprocessing
|
Oracle: Memory sorts ratio | The percentage of sorts (from ORDER BY clauses or index building) that are done to disk vs in-memory. |
Dependent item | oracle.memory_sorts_ratio Preprocessing
|
Oracle: Database wait time ratio | Wait time - the time that the server process spends waiting for available shared resources to be released by other server processes, such as latches, locks, data buffers, etc. |
Dependent item | oracle.database_wait_time_ratio Preprocessing
|
Oracle: Database CPU time ratio | It is calculated by dividing the total CPU (used by the database) by the Oracle time model statistic DB time. |
Dependent item | oracle.database_cpu_time_ratio Preprocessing
|
Oracle: Temp space used | Used temporary space. |
Dependent item | oracle.temp_space_used Preprocessing
|
Oracle: PGA, Total inuse | It indicates how much the Program Global Area (PGA) memory is currently consumed by work areas. This number can be used to determine how much memory is consumed by other consumers of the PGA memory (for example, PL/SQL or Java). |
Dependent item | oracle.total_pga_used Preprocessing
|
Oracle: PGA, Aggregate target parameter | The current value of the PGA_AGGREGATE_TARGET initialization parameter. If this parameter is not set, then its value is 0 and automatic management of the PGA memory is disabled. |
Dependent item | oracle.pga_target Preprocessing
|
Oracle: PGA, Total allocated | The current amount of the PGA memory allocated by the instance. The Oracle Database attempts to keep this number below the value of the PGA_AGGREGATE_TARGET initialization parameter. However, it is possible for the PGA allocated to exceed that value by a small percentage and for a short period of time when the work area workload is increasing very rapidly or when PGA_AGGREGATE_TARGET is set to a small value. |
Dependent item | oracle.total_pga_allocated Preprocessing
|
Oracle: PGA, Total freeable | The number of bytes of the PGA memory in all processes that could be freed back to the operating system. |
Dependent item | oracle.total_pga_freeable Preprocessing
|
Oracle: PGA, Global memory bound | The maximum size of work area executed in automatic mode. |
Dependent item | oracle.pga_global_bound Preprocessing
|
Oracle: FRA, Space limit | The maximum amount of disk space (in bytes) that the database can use for the Fast Recovery Area (FRA). |
Dependent item | oracle.fra_space_limit Preprocessing
|
Oracle: FRA, Used space | The amount of disk space (in bytes) used by FRA files created in the current and all the previous FRAs. |
Dependent item | oracle.fra_space_used Preprocessing
|
Oracle: FRA, Space reclaimable | The total amount of disk space (in bytes) that can be created by deleting obsolete, redundant, and other low priority files from the FRA. |
Dependent item | oracle.fra_space_reclaimable Preprocessing
|
Oracle: FRA, Number of files | The number of files in the FRA. |
Dependent item | oracle.fra_number_of_files Preprocessing
|
Oracle: FRA, Usable space in % | Dependent item | oracle.fra_usable_pct Preprocessing
|
|
Oracle: FRA, Number of restore points | Dependent item | oracle.fra_restore_point Preprocessing
|
|
Oracle: SGA, java pool | The memory is allocated from the Java pool. |
Dependent item | oracle.sga_java_pool Preprocessing
|
Oracle: SGA, large pool | The memory is allocated from a large pool. |
Dependent item | oracle.sga_large_pool Preprocessing
|
Oracle: SGA, shared pool | The memory is allocated from a shared pool. |
Dependent item | oracle.sga_shared_pool Preprocessing
|
Oracle: SGA, log buffer | The number of bytes allocated for the redo log buffer. |
Dependent item | oracle.sga_log_buffer Preprocessing
|
Oracle: SGA, fixed | The fixed System Global Area (SGA) is an internal housekeeping area. |
Dependent item | oracle.sga_fixed Preprocessing
|
Oracle: SGA, buffer cache | The size of standard block cache. |
Dependent item | oracle.sga_buffer_cache Preprocessing
|
Oracle: Redo logs available to switch | The number of inactive/unused redo logs available for log switching. |
Dependent item | oracle.redo_logs_available Preprocessing
|
Triggers
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
Oracle: Port {$ORACLE.PORT} is unavailable | The TCP port of the Oracle Server service is currently unavailable. |
max(/Oracle by ODBC/net.tcp.service[tcp,{HOST.CONN},{$ORACLE.PORT}],#3)=0 and max(/Oracle by ODBC/proc.num[,,,"tnslsnr LISTENER"],#3)>0 |
Disaster | |
Oracle: LISTENER process is not running | max(/Oracle by ODBC/proc.num[,,,"tnslsnr LISTENER"],#3)=0 |
Disaster | ||
Oracle: Version has changed | The Oracle DB version has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.version,#1)<>last(/Oracle by ODBC/oracle.version,#2) and length(last(/Oracle by ODBC/oracle.version))>0 |
Info | Manual close: Yes |
Oracle: Host has been restarted | Uptime is less than 10 minutes. |
last(/Oracle by ODBC/oracle.uptime)<10m |
Info | Manual close: Yes |
Oracle: Failed to fetch info data | Zabbix has not received any data for the items for the last 5 minutes. The database might be unavailable for connecting. |
nodata(/Oracle by ODBC/oracle.uptime,5m)=1 |
Warning | Depends on:
|
Oracle: Instance name has changed | The Oracle DB instance has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.instance_name,#1)<>last(/Oracle by ODBC/oracle.instance_name,#2) and length(last(/Oracle by ODBC/oracle.instance_name))>0 |
Info | Manual close: Yes |
Oracle: Instance hostname has changed | Oracle DB Instance hostname has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.instance_hostname,#1)<>last(/Oracle by ODBC/oracle.instance_hostname,#2) and length(last(/Oracle by ODBC/oracle.instance_hostname))>0 |
Info | Manual close: Yes |
Oracle: Too many active processes | Active processes are using more than {$ORACLE.PROCESSES.MAX.WARN}% of the available number of processes. |
min(/Oracle by ODBC/oracle.processes_count,5m) * 100 / last(/Oracle by ODBC/oracle.processes_limit) > {$ORACLE.PROCESSES.MAX.WARN} |
Warning | |
Oracle: Too many database files | The number of datafiles is higher than {$ORACLE.DB.FILE.MAX.WARN}% of the available datafiles limit. |
min(/Oracle by ODBC/oracle.db_files_count,5m) * 100 / last(/Oracle by ODBC/oracle.db_files_limit) > {$ORACLE.DB.FILE.MAX.WARN} |
Warning | |
Oracle: Shared pool free is too low | The free memory percent of the shared pool has been less than {$ORACLE.SHARED.FREE.MIN.WARN}% for the last 5 minutes. |
max(/Oracle by ODBC/oracle.shared_pool_free,5m)<{$ORACLE.SHARED.FREE.MIN.WARN} |
Warning | |
Oracle: Too many active sessions | Active sessions are using more than {$ORACLE.SESSIONS.MAX.WARN}% of the available sessions. |
min(/Oracle by ODBC/oracle.session_count,5m) * 100 / last(/Oracle by ODBC/oracle.session_limit) > {$ORACLE.SESSIONS.MAX.WARN} |
Warning | |
Oracle: Too many locked sessions | The number of locked sessions exceeds {$ORACLE.SESSIONS.LOCK.MAX.WARN}% of the running sessions. |
min(/Oracle by ODBC/oracle.session_lock_rate,5m) > {$ORACLE.SESSIONS.LOCK.MAX.WARN} |
Warning | |
Oracle: Too many sessions locked | The number of locked sessions exceeding {$ORACLE.SESSION.LOCK.MAX.TIME} seconds is too high. Long-term locks can negatively affect the database performance. Therefore, if they are detected, you should first find the most difficult queries from the database point of view and then analyze possible resource leaks. |
min(/Oracle by ODBC/oracle.session_long_time_locked,5m) > {$ORACLE.SESSION.LONG.LOCK.MAX.WARN} |
Warning | |
Oracle: Too high database concurrency | The concurrency rate exceeds {$ORACLE.CONCURRENCY.MAX.WARN}%. A high contention value does not indicate the root cause of the problem, but it is a signal to search for it. In the case of high competition, the analysis of resource consumption should be carried out. Which are the most "heavy" queries made in the database? Possibly, also session tracing. All this will help to determine the root cause and possible optimization points both in the database configuration and in the logic of building queries of the application itself. |
min(/Oracle by ODBC/oracle.session_concurrency_rate,5m) > {$ORACLE.CONCURRENCY.MAX.WARN} |
Warning | |
Oracle: Zabbix account will expire soon | The password for Zabbix user in the database expires soon. |
last(/Oracle by ODBC/oracle.user_expire_password) < {$ORACLE.EXPIRE.PASSWORD.MIN.WARN} |
Warning | |
Oracle: Total PGA inuse is too high | The total PGA currently consumed by work areas is more than {$ORACLE.PGA.USE.MAX.WARN}% of PGA_AGGREGATE_TARGET. |
min(/Oracle by ODBC/oracle.total_pga_used,5m) * 100 / last(/Oracle by ODBC/oracle.pga_target) > {$ORACLE.PGA.USE.MAX.WARN} |
Warning | |
Oracle: Number of REDO logs available for switching is too low | The number of inactive/unused REDOs available for log switching is low (database down risk). |
max(/Oracle by ODBC/oracle.redo_logs_available,5m) < {$ORACLE.REDO.MIN.WARN} |
Warning |
LLD rule Database discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Database discovery | Scanning databases in the database management system (DBMS). |
Database monitor | db.odbc.discovery[db_list,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Item prototypes for Database discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Oracle Database '{#DBNAME}': Get CDB and No-CDB info | It gets the information about the container database (CDB) and non-CDB database on an instance. |
Database monitor | db.odbc.get[get_cdb_{#DBNAME}_info,,"Driver={ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"]<p>**Preprocessing**</p><ul><li><p>JSON Path: ` .first()`⛔️Custom on fail: Discard value |
Oracle Database '{#DBNAME}': Open status | 1 - 'MOUNTED'; 2 - 'READ WRITE'; 3 - 'READ ONLY'; 4 - 'READ ONLY WITH APPLY' (a physical standby database is open in real-time query mode). |
Dependent item | oracle.db_open_mode["{#DBNAME}"] Preprocessing
|
Oracle Database '{#DBNAME}': Role | The current role of the database where: 1 - 'SNAPSHOT STANDBY'; 2 - 'LOGICAL STANDBY'; 3 - 'PHYSICAL STANDBY'; 4 - 'PRIMARY '; 5 - 'FAR SYNC'. |
Dependent item | oracle.db_role["{#DBNAME}"] Preprocessing
|
Oracle Database '{#DBNAME}': Log mode | The archive log mode where: 0 - 'NOARCHIVELOG'; 1 - 'ARCHIVELOG'; 2 - 'MANUAL'. |
Dependent item | oracle.db_log_mode["{#DBNAME}"] Preprocessing
|
Oracle Database '{#DBNAME}': Force logging | It indicates whether the database is under force logging mode 'YES' or 'NO'. |
Dependent item | oracle.db_force_logging["{#DBNAME}"] Preprocessing
|
Trigger prototypes for Database discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
Oracle Database '{#DBNAME}': Open status in mount mode | The Oracle DB is in a mounted state. |
last(/Oracle by ODBC/oracle.db_open_mode["{#DBNAME}"])=1 |
Warning | |
Oracle Database '{#DBNAME}': Open status has changed | The Oracle DB open status has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.db_open_mode["{#DBNAME}"],#1)<>last(/Oracle by ODBC/oracle.db_open_mode["{#DBNAME}"],#2) |
Info | Manual close: Yes Depends on:
|
Oracle Database '{#DBNAME}': Role has changed | The Oracle DB role has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.db_role["{#DBNAME}"],#1)<>last(/Oracle by ODBC/oracle.db_role["{#DBNAME}"],#2) |
Info | Manual close: Yes |
Oracle Database '{#DBNAME}': Force logging is deactivated for DB with active Archivelog | Force Logging mode - it is very important metric for Databases in 'ARCHIVELOG'. This feature allows to forcibly write all the transactions to the REDO. |
last(/Oracle by ODBC/oracle.db_force_logging["{#DBNAME}"]) = 0 and last(/Oracle by ODBC/oracle.db_log_mode["{#DBNAME}"]) = 1 |
Warning |
LLD rule PDB discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
PDB discovery | Scanning a pluggable database (PDB) in DBMS. |
Database monitor | db.odbc.discovery[pdb_list,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Item prototypes for PDB discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Oracle Database '{#DBNAME}': Get PDB info | It gets the information about the PDB database on an instance. |
Database monitor | db.odbc.get[get_pdb_{#DBNAME}_info,,"Driver={ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"]<p>**Preprocessing**</p><ul><li><p>JSON Path: ` .first()`⛔️Custom on fail: Discard value |
Oracle Database '{#DBNAME}': Open status | 1 - 'MOUNTED'; 2 - 'READ WRITE'; 3 - 'READ ONLY'; 4 - 'READ ONLY WITH APPLY' (a physical standby database is open in real-time query mode). |
Dependent item | oracle.pdb_open_mode["{#DBNAME}"] Preprocessing
|
Trigger prototypes for PDB discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
Oracle Database '{#DBNAME}': Open status in mount mode | The Oracle DB is in a mounted state. |
last(/Oracle by ODBC/oracle.pdb_open_mode["{#DBNAME}"])=1 |
Warning | |
Oracle Database '{#DBNAME}': Open status has changed | The Oracle DB open status has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.pdb_open_mode["{#DBNAME}"],#1)<>last(/Oracle by ODBC/oracle.pdb_open_mode["{#DBNAME}"],#2) |
Info | Manual close: Yes |
LLD rule Tablespace discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Tablespace discovery | Scanning tablespaces in DBMS. |
Database monitor | db.odbc.discovery[tbsname,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Item prototypes for Tablespace discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Get tablespaces stats | It gets the statistics of the tablespace. |
Database monitor | db.odbc.get[get_{#CON_NAME}tablespace{#TABLESPACE}_stats,,"Driver={ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"]<p>**Preprocessing**</p><ul><li><p>JSON Path: ` .first()`⛔️Custom on fail: Discard value |
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace allocated, bytes | Currently allocated bytes for the tablespace (sum of the current size of datafiles). |
Dependent item | oracle.tbs_alloc_bytes["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace MAX size, bytes | The maximum size of the tablespace. |
Dependent item | oracle.tbs_max_bytes["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace used, bytes | Currently used bytes for the tablespace (current size of datafiles - the free space). |
Dependent item | oracle.tbs_used_bytes["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace free, bytes | Free bytes of the allocated space. |
Dependent item | oracle.tbs_free_bytes["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace allocated, percent | Allocated bytes/max bytes*100. |
Dependent item | oracle.tbs_used_pct["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace usage, percent | Used bytes/allocated bytes*100. |
Dependent item | oracle.tbs_used_file_pct["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Open status | The tablespace status where: 1 - 'ONLINE'; 2 - 'OFFLINE'; 3 - 'READ ONLY'. |
Dependent item | oracle.tbs_status["{#CON_NAME}","{#TABLESPACE}"] Preprocessing
|
Trigger prototypes for Tablespace discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace utilization is too high | min(/Oracle by ODBC/oracle.tbs_used_pct["{#CON_NAME}","{#TABLESPACE}"],5m)>{$ORACLE.TBS.USED.PCT.MAX.WARN} |
Warning | Depends on:
|
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace utilization is too high | min(/Oracle by ODBC/oracle.tbs_used_pct["{#CON_NAME}","{#TABLESPACE}"],5m)>{$ORACLE.TBS.UTIL.PCT.MAX.HIGH} |
High | ||
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace usage is too high | min(/Oracle by ODBC/oracle.tbs_used_file_pct["{#CON_NAME}","{#TABLESPACE}"],5m)>{$ORACLE.TBS.USED.PCT.MAX.WARN} |
Warning | Depends on:
|
|
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace usage is too high | min(/Oracle by ODBC/oracle.tbs_used_file_pct["{#CON_NAME}","{#TABLESPACE}"],5m)>{$ORACLE.TBS.USED.PCT.MAX.HIGH} |
High | ||
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace is OFFLINE | The tablespace is in the offline state. |
last(/Oracle by ODBC/oracle.tbs_status["{#CON_NAME}","{#TABLESPACE}"])=2 |
Warning | |
Oracle '{#CON_NAME}' TBS '{#TABLESPACE}': Tablespace status has changed | Oracle tablespace status has changed. Acknowledge to close the problem manually. |
last(/Oracle by ODBC/oracle.tbs_status["{#CON_NAME}","{#TABLESPACE}"],#1)<>last(/Oracle by ODBC/oracle.tbs_status["{#CON_NAME}","{#TABLESPACE}"],#2) |
Info | Manual close: Yes Depends on:
|
LLD rule Archive log discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Archive log discovery | Destinations of the log archive. |
Database monitor | db.odbc.discovery[archivelog,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Item prototypes for Archive log discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Archivelog '{#DEST_NAME}': Get archive log info | It gets the archivelog statistics. |
Database monitor | db.odbc.get[get_archivelog_{#DEST_NAME}_stat,,"Driver={ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"]<p>**Preprocessing**</p><ul><li><p>JSON Path: ` .first()`⛔️Custom on fail: Discard value |
Archivelog '{#DEST_NAME}': Error | It displays the error message. |
Dependent item | oracle.archivelog_error["{#DEST_NAME}"] Preprocessing
|
Archivelog '{#DEST_NAME}': Last sequence | It identifies the sequence number of the last archived redo log to be archived. |
Dependent item | oracle.archivelog_log_sequence["{#DEST_NAME}"] Preprocessing
|
Archivelog '{#DEST_NAME}': Status | It identifies the current status of the destination where: 1 - 'VALID'; 2 - 'DEFERRED'; 3 - 'ERROR'; 0 - 'UNKNOWN'. |
Dependent item | oracle.archivelog_log_status["{#DEST_NAME}"] Preprocessing
|
Trigger prototypes for Archive log discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
Archivelog '{#DEST_NAME}': Log Archive is not valid | The trigger will launch if the archive log destination is not in one of these states: |
last(/Oracle by ODBC/oracle.archivelog_log_status["{#DEST_NAME}"])<2 |
High |
LLD rule ASM disk groups discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
ASM disk groups discovery | The ASM disk groups. |
Database monitor | db.odbc.discovery[asm,,"Driver={$ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"] |
Item prototypes for ASM disk groups discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
ASM '{#DGNAME}': Get ASM stats | It gets the ASM disk group statistics. |
Database monitor | db.odbc.get[get_asm_{#DGNAME}_stat,,"Driver={ORACLE.DRIVER};DBQ=//{HOST.CONN}:{$ORACLE.PORT}/{$ORACLE.SERVICE};"]<p>**Preprocessing**</p><ul><li><p>JSON Path: ` .first()`⛔️Custom on fail: Discard value |
ASM '{#DGNAME}': Total size | The total size of the ASM disk group. |
Dependent item | oracle.asm_total_size["{#DGNAME}"] Preprocessing
|
ASM '{#DGNAME}': Free size | The free size of the ASM disk group. |
Dependent item | oracle.asm_free_size["{#DGNAME}"] Preprocessing
|
ASM '{#DGNAME}': Used size, percent | Usage of the ASM disk group expressed in %. |
Dependent item | oracle.asm_used_pct["{#DGNAME}"] Preprocessing
|
Trigger prototypes for ASM disk groups discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
ASM '{#DGNAME}': Disk group usage is too high | The usage of the ASM disk group expressed in % exceeds {$ORACLE.ASM.USED.PCT.MAX.WARN}. |
min(/Oracle by ODBC/oracle.asm_used_pct["{#DGNAME}"],5m)>{$ORACLE.ASM.USED.PCT.MAX.WARN} |
Warning | Depends on:
|
ASM '{#DGNAME}': Disk group usage is too high | The usage of the ASM disk group expressed in % exceeds {$ORACLE.ASM.USED.PCT.MAX.WARN}. |
min(/Oracle by ODBC/oracle.asm_used_pct["{#DGNAME}"],5m)>{$ORACLE.ASM.USED.PCT.MAX.HIGH} |
High |
Feedback
Please report any issues with the template at https://support.zabbix.com
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums