Skip to content

Latest commit

 

History

History
82 lines (53 loc) · 3.11 KB

README.md

File metadata and controls

82 lines (53 loc) · 3.11 KB

oralog

Ingestion tool for quick data collection. Purpose of oralog is in loading various data based on database audit and diagnostics log to Hadoop, Elasticsearch, Amazon S3 or other tools for further processing and analyzing. oralog not just sends data but converts data to JSON format too. The following data are supported by oralog:

oralog can operate in different modes as

  1. Kafka Connect source connector
  2. Apache Kafka producer
  3. Amazon Kinesis producer

Getting Started

These instructions will get you a copy of the project up and running on your server.

Prerequisites

Before using oralog please check that required Java8+ is installed with

echo "Checking Java version"
java -version

Installing

Build with

mvn install

Then run as root supplied install.sh passing target installation directory as script parameter. This directory will be mentioned hereinafter as A2_LOG_HOME. For example:

install.sh /opt/a2/oralog

This will create following directory structure under A2_LOG_HOME

bin - shell scripts conf - configuration files doc - doc files lib - jar files log - producer's log

Running and using oralog

Processing Oracle Automatic Diagnostic Repository files

Please look to ORALOG4ORAADR.md. For schema used for conversion of Oracle ADR xml to JSON please refer to adr.xsd

Processing Oracle Audit XML files

Please look to ORALOG4ORAAUD.md Mapping between JSON produced by oralog and Oracle RDBMS views available at ORA-AUDIT-SCHEMA.md For Oracle Database Audit XML schema please visit http://xmlns.oracle.com/oracleas/schema/dbserver_audittrail-11_2.xsd and http://xmlns.oracle.com/oracleas/schema/dbserver_audittrail-12_2.xsd

Built With

  • Maven - Dependency Management

TODO

Version history

####0.7.0#### Initial release

Authors

License

This project is licensed under the Apache License - see the LICENSE file for details