wehub-resource-sync
180 lines
10 KiB
Markdown
180 lines
10 KiB
Markdown
---
|
||
id: oracle
|
||
title: Monitoring：ORACLE database monitoring
|
||
sidebar_label: ORACLE database
|
||
keywords: [open source monitoring tool, open source database monitoring tool, monitoring oracle database metrics]
|
||
---
|
||
|
||
> Collect and monitor the general performance Metrics of ORACLE database.
|
||
|
||
## Attention, Need Add ORACLE jdbc driver jar
|
||
|
||
- Download the ORACLE jdbc driver jar package, such as [ojdbc8.jar](https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/23.4.0.24.05/ojdbc8-23.4.0.24.05.jar) [oracle-i18n](https://repo.mavenlibs.com/maven/com/oracle/database/nls/orai18n/21.5.0.0/orai18n-21.5.0.0.jar)
|
||
- Copy the jar package to the `hertzbeat/ext-lib` directory.
|
||
- Restart the HertzBeat service.
|
||
|
||
:::important Collector package selection
|
||
Oracle monitoring requires external JDBC driver loading from `ext-lib`.
|
||
|
||
- Use HertzBeat server built-in collector or the JVM collector package for Oracle monitoring
|
||
- Do not use the native collector package for Oracle monitoring
|
||
:::
|
||
|
||
### Configuration parameter
|
||
|
||
| Parameter name | Parameter help description |
|
||
|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| Monitoring Host | Monitored IPV4, IPV6 or domain name. Note⚠️Without protocol header (eg: https://, http://) |
|
||
| Monitoring name | Identify the name of this monitoring. The name needs to be unique |
|
||
| Port | Port provided by the database. The default is 1521 |
|
||
| Query timeout | Set the timeout time when SQL query does not respond to data, unit: ms, default: 3000ms |
|
||
| Database name | Database instance name, optionalIf you need to use a dba user, you can fill in like "sys as sysdba". |
|
||
| Username | Database connection user name, optional |
|
||
| Password | Database connection password, optional |
|
||
| URL | Database connection URL，optional，If configured, the database name, user name, password and other parameters in the URL will overwrite the above configured parameters |
|
||
| Collection interval | Interval time of monitor periodic data collection, unit: second, and the minimum interval that can be set is 30 seconds |
|
||
| Whether to detect | Whether to detect and check the availability of monitoring before adding monitoring. Adding and modifying operations will continue only after the detection is successful |
|
||
| Description remarks | For more information about identifying and describing this monitoring, users can note information here |
|
||
|
||
### Collection Metric
|
||
|
||
#### Metric set：basic
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|------------------|-------------|-------------------------|
|
||
| database_version | none | Database version |
|
||
| hostname | none | Host name |
|
||
| instance_name | none | Database instance name |
|
||
| startup_time | none | Database start time |
|
||
| status | none | Database status |
|
||
|
||
#### Metric set：tablespace
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-----------------|-------------|-------------------------|
|
||
| file_id | none | File ID |
|
||
| file_name | none | File name |
|
||
| tablespace_name | none | Table space name |
|
||
| status | none | Status |
|
||
| bytes | MB | Size |
|
||
| blocks | none | Number of blocks |
|
||
|
||
#### Metric set：total_sessions
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|---------------------------|
|
||
| counts | number | Current connection counts |
|
||
|
||
#### Metric set：active_sessions
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-------------------------|
|
||
| counts | number | Active sessions counts |
|
||
|
||
#### Metric set：background_sessions
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|----------------------------|
|
||
| counts | number | Background sessions counts |
|
||
|
||
#### Metric set：connection
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-------------------------|
|
||
| username | none | User name |
|
||
| counts | number | User sessions counts |
|
||
|
||
#### Metric set：performance
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-----------------------------|
|
||
| qps | QPS | I/O Requests per second |
|
||
| tps | TPS | User transaction per second |
|
||
| mbps | MBPS | I/O Megabytes per second |
|
||
|
||
#### Metric set：percentage
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-----------------|---------------|-------------------------|
|
||
| tablespace_name | none | Tablespace name |
|
||
| total | none | Total |
|
||
| used | none | Used |
|
||
| free | none | Free |
|
||
| used_percentage | percentage(%) | Used Percentage |
|
||
| free_percentage | percentage(%) | Free Percentage |
|
||
|
||
#### Metric set：process
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|---------------|-------------|-------------------------|
|
||
| process_count | none | Process count |
|
||
|
||
#### Metric set：transaction
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-------------------------|
|
||
| commits | t/s | User Commits Per Sec |
|
||
| rollbacks | t/s | User Rollbacks Per Sec |
|
||
|
||
#### Metric set：wait
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|----------------------|-------------|-------------------------|
|
||
| concurrent_wait_time | ms | Concurrent Wait Time |
|
||
| commit_wait_time | ms | Commit Wait Time |
|
||
| app_wait_time | ms | Application Wait Time |
|
||
| network_wait_time | ms | Network Wait Time |
|
||
| system_io_wait_time | ms | System I/O Wait Time |
|
||
| user_io_wait_time | ms | User I/O Wait Time |
|
||
| configure_wait_time | ms | Configure Wait Time |
|
||
| scheduler_wait_time | ms | Scheduler Wait Time |
|
||
|
||
#### Metric set：cpu_stats
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-------------------------|
|
||
| type | none | Type |
|
||
| num | none | Num |
|
||
|
||
#### Metric set：mem_stats
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|-------------|-------------|-------------------------|
|
||
| type | none | Type |
|
||
| num | none | Num |
|
||
|
||
#### Metric set：cache_hit_ratio
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|------------------------|-------------|-------------------------|
|
||
| lib_cache_hit_ratio | none | Library Cache Hit Ratio |
|
||
| buffer_cache_hit_ratio | none | Buffer Cache Hit Ratio |
|
||
|
||
#### Metric set：slow_query
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|----------------|-------------|-------------------------|
|
||
| sql_id | none | SQL ID |
|
||
| child_number | none | Child Number |
|
||
| executions | none | EXECUTIONS |
|
||
| per_secs | seconds | Per Secs |
|
||
| cpu_secs | seconds | CPU Secs |
|
||
| buffer_gets | none | Buffer Gets |
|
||
| disk_reads | none | Disk Reads |
|
||
| fetches | none | Fetches |
|
||
| parse_calls | none | Parse Calls |
|
||
| optimizer_cost | none | Optimizer Cost |
|
||
| sql_text | none | SQL Text |
|
||
|
||
#### Metric set：users
|
||
|
||
| Metric name | Metric unit | Metric help description |
|
||
|---------------------|-------------|---------------------------------------------------------------------------------------------------|
|
||
| username | none | User Name |
|
||
| account_status | none | Account Status |
|
||
| lock_date | none | If the account status is LOCKED, the date and time when the account was locked will be displayed. |
|
||
| expiry_date | none | Password Expiry Date |
|
||
| expiry_seconds | seconds | Password Validity Period Remaining |
|
||
| created | none | Creation Date |
|
||
| authentication_type | none | Authentication Type |
|