Skip to content

Commit 109b313

Browse files
sumoanemaJV0812
andauthored
Apply suggestions from code review
Co-authored-by: Jagadisha V <[email protected]>
1 parent f11e77d commit 109b313

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

docs/integrations/databases/opentelemetry/oracle-opentelemetry.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ This app is tested with the following Oracle versions:
1717

1818
- Non-Kubernetes: Oracle Database 23 Release 23.4.0.24.05.
1919

20-
Oracle logs like listner, alert and traditional audit logs (oracle version <= 19c) are sent to Sumo Logic through OpenTelemetry [filelog receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/filelogreceiver) whereas unified audit logs (oracle version >= 21c) are collected through [syslog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/syslogreceiver) for linux environment and [windowseventlog](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/windowseventlogreceiver/) receiver for windows environment.
20+
Oracle logs, such as listener, alert, and traditional audit logs (oracle version <= 19c) are sent to Sumo Logic through OpenTelemetry [filelog receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/filelogreceiver) whereas, unified audit logs (oracle version >= 21c) are collected through [syslog](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/syslogreceiver) for the Linux environment and [windowseventlog](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/windowseventlogreceiver/) receiver for windows environment.
2121

22-
Metrics are collected through [Oracledb receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/oracledbreceiver)
22+
Metrics are collected through [Oracledb receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/oracledbreceiver).
2323

2424
<img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/Oracle-OpenTelemetry/Oracle-Schematics.png' alt="Schematics" />
2525

@@ -90,8 +90,8 @@ If logging is not enabled, you can configure it by following the steps below.
9090
9191
The location of these logs will be required when you set up the app through the app catalog.
9292
93-
- **For Oracle version 21c and above**. Based on [Unified audit policy](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/AUDIT-Unified-Auditing.html) configuered, audit logs exported will direclty be ingested to sumo using syslog or windows event log.
94-
For linux environment instead of redirecting audit logs to a file we need to directly redirect it to local port. In the next step, otel collector can be configured to listen to this port to send log to sumo. This can be done using a below configuration in rsyslog.conf :
93+
- **For Oracle version 21c and above**. Based on the [Unified audit policy](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/AUDIT-Unified-Auditing.html) configured, audit logs exported will be directly ingested to Sumo Logic using syslog or windows event log.
94+
For the Linux environment, instead of redirecting audit logs to a file, we need to redirect them to the local port. In the next step, the OTel collector can be configured to listen to this port and then send the log to Sumo Logic. This can be done using the below configuration in the `rsyslog.conf`. :
9595
```local7.info @@127.0.0.1:10514```
9696
This will redirect all the unified audit logs to localhost port 10514.
9797
@@ -185,8 +185,8 @@ Below are the inputs required:
185185
- **`Alert Logs`**. Path of the log file configured to capture oracle alert logs.
186186
- **`Listener Logs`**. Path of the log file configured to capture oracle listener logs .
187187
- **`Audit Logs`**.
188-
- For **Traditional Audit Logs** - Path of the log file configured to capture oracle audit logs.
189-
- For **Unified Audit Logs** - You need to select the OS where the oracle is setup - windows or linux. For Oracle on windows machine no parameter is required. Only respective event id will be ingested. For linux environment you need to give the **port** (configured in prerequisite steps for linux environment) where the syslog receiver should listen to, for sending the logs to sumo.
188+
- For **Traditional Audit Logs**, path of the log file is configured to capture oracle audit logs.
189+
- For **Unified Audit Logs**, you need to select the OS where the Oracle is setup - Windows or Linux. For Oracle on Windows machine, no parameter is required. Only respective event IDs will be ingested. For the Linux environment, you need to provide the **port** (configured in pre-requisite steps for the Linux environment) which the syslog receiver should listen to for sending the logs to Sumo Logic.
190190
- **`Performance metric script-based logs`**. Path of the log file configured to capture log generated through script can be configured in other logs.
191191
- **`Endpoint (no default)`**. Endpoint used to connect to the OracleDB server. Must be in the format of `host:port`.
192192
- **`username`**. Username for the OracleDB connection.
@@ -552,7 +552,7 @@ Recent Jobs in the database. A table of information about recent database jobs,
552552
### Unified Audit Syslog
553553

554554
<img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/Oracle-OpenTelemetry/Oracle-Unified-Audit-Syslog.png' alt="Monitor Performance by DB Script" />
555-
See information derived from the syslog audit trail, including successful and failed activities, successful and failed logon attempts. In addition to this dashboard gives insight around logon status trend, top current and database users. This dashboard work with unified audit logs exported from both windows and linux environment.
555+
See information derived from the syslog audit trail, including successful and failed activities, successful and failed logon attempts. Additionally, this dashboard also provides insight around logon status trend, top current, and database users. This dashboard work with unified audit logs exported from both Windows and Linux environment.
556556

557557
### Performance Details
558558

0 commit comments

Comments
 (0)