newrelic-experimental / newrelic-java-osb-12

Provides instrumentation for Oracle Service Bus v12

New Relic Java Instrumentation for Oracle Service Bus 12

Provides Java instrumentation for Oracle Service Bus 12 applications.

Installation

To install:

1. Download the latest release jar files.
2. In the New Relic Java directory (the one containing newrelic.jar), create a directory named extensions if it does not already exist.
3. Copy the downloaded jars into the extensions directory.
4. Restart the application.

Getting Started

Once installed the New Relic Java Agent will start tracing elements in OSB not captured by the Java Agent out of the box. This includes things like Pipelines and Transports. Although the list of components is fairly through there still may be components that still need instrumentation.

Building

Building the extension requires that Gradle is installed.

Because Oracle Service Bus is not an open source framework, it is assumed that you have access to a valid OSB instance in order to build the extensons. You will need to copy jar files from your installation to the lib directory of the extension that you want to build. Each lib directory contains a holder.txt file that contains the list of necessary jar files from your installation.

To build the extension jars from source, follow these steps: To build the extension jars from source, follow these steps:

Build single extension

To build a single extension with name extension, do the following:

1. Set an environment variable NEW_RELIC_EXTENSIONS_DIR and set its value to the directory where you want the jar file built.
2. Run the command: gradlew extension:clean extension:install

Build all extensions

To build all extensions, do the following:

1. Set an environment variable NEW_RELIC_EXTENSIONS_DIR and set its value to the directory where you want the jar file built.
2. Run the command: gradlew clean install.

Support

New Relic has open-sourced this project. This project is provided AS-IS WITHOUT WARRANTY OR DEDICATED SUPPORT. Issues and contributions should be reported to the project here on GitHub.

We encourage you to bring your experiences and questions to the Explorers Hub where our community members collaborate on solutions and new ideas.

Contributing

We encourage your contributions to improve Salesforce Commerce Cloud for New Relic Browser! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at [email protected].

A note about vulnerabilities

As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.

If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.

License

[Project Name] is licensed under the Apache 2.0 License.

[If applicable: [Project Name] also uses source code from third-party libraries. You can find full details on which libraries are used and the terms under which they are licensed in the third-party notices document.]

newrelic-java-osb-12's Issues

[Repolinter] Open Source Policy Issues

Repolinter Report

🤖This issue was automatically generated by repolinter-action, developed by the Open Source and Developer Advocacy team at New Relic. This issue will be automatically updated or closed when changes are pushed. If you have any problems with this tool, please feel free to open a GitHub issue or give us a ping in #help-opensource.

This Repolinter run generated the following results:

❗ Error	❌ Fail	⚠️ Warn	✅ Pass	Ignored	Total
0	0	1	5	0	6

• Warning
  • ⚠️ third-party-notices-file-exists
• Passed
  • ✅ license-file-exists
  • ✅ readme-file-exists
  • ✅ readme-starts-with-experimental-header
  • ✅ readme-contains-link-to-security-policy
  • ✅ code-of-conduct-should-not-exist-here

Warning #

Click to see rules

⚠️ third-party-notices-file-exists #

A THIRD_PARTY_NOTICES.md file can be present in your repository to grant attribution to all dependencies being used by this project. This document is necessary if you are using third-party source code in your project, with the exception of code referenced outside the project's compiled/bundled binary (ex. some Java projects require modules to be pre-installed in the classpath, outside the project binary and therefore outside the scope of the THIRD_PARTY_NOTICES). Please review your project's dependencies and create a THIRD_PARTY_NOTICES.md file if necessary. For JavaScript projects, you can generate this file using the oss-cli. For more information please visit https://docs.google.com/document/d/1y644Pwi82kasNP5VPVjDV8rsmkBKclQVHFkz8pwRUtE/view. Did not find a file matching the specified patterns. Below is a list of files or patterns that failed:

• THIRD_PARTY_NOTICES*
• THIRD-PARTY-NOTICES*
• THIRDPARTYNOTICES*

Passed #

Click to see rules

✅ license-file-exists #

Found file (LICENSE). New Relic requires that all open source projects have an associated license contained within the project. This license must be permissive (e.g. non-viral or copyleft), and we recommend Apache 2.0 for most use cases. For more information please visit https://docs.google.com/document/d/1vML4aY_czsY0URu2yiP3xLAKYufNrKsc7o4kjuegpDw/edit.

✅ readme-file-exists #

Found file (README.md). New Relic requires a README file in all projects. This README should give a general overview of the project, and should point to additional resources (security, contributing, etc.) where developers and users can learn further. For more information please visit https://github.com/newrelic/open-source-tools/tree/master/nerdpacks/oss-template.

✅ readme-starts-with-experimental-header #

The first 5 lines contain all of the requested patterns. (README.md). The README of an experimental project should have an experimental header at the start of the README. If you already have an experimental header and this rule is failing, your header may be out of date, and you should update your header with the suggested one below. For more information please visit https://opensource.newrelic.com/oss-category/.

✅ readme-contains-link-to-security-policy #

Contains a link to the security policy for this repository (README.md). New Relic recommends putting a link to the open source security policy for your project (https://github.com/newrelic-experimental/<repo-name>/security/policy or ../../security/policy) in the README. For an example of this, please see the "a note about vulnerabilities" section of the Open By Default repository. For more information please visit https://nerdlife.datanerd.us/new-relic/security-guidelines-for-publishing-source-code.

✅ code-of-conduct-should-not-exist-here #

New Relic has moved the CODE_OF_CONDUCT file to a centralized location where it is referenced automatically by every repository in the New Relic organization. Because of this change, any other CODE_OF_CONDUCT file in a repository is now redundant and should be removed. Note that you will need to adjust any links to the local CODE_OF_CONDUCT file in your documentation to point to the central file (README and CONTRIBUTING will probably have links that need updating). For more information please visit https://docs.google.com/document/d/1y644Pwi82kasNP5VPVjDV8rsmkBKclQVHFkz8pwRUtE/view. Did not find a file matching the specified patterns. All files passed this test.

Extension load issue

[NOTE]: Extension load issue

Expected Behavior

Load all *jar

Relevant Logs / Console output

Oracle OSB server based on weblogic 12c

[oracle@test-server-domain1-osb-server16 oracle]$ ls -ls /u01/newrelic/
total 20012
0 drwxr-xr-x. 2 oracle oracle 235 Nov 15 17:55 extensions
0 drwxr-x---. 2 oracle oracle 32 Dec 7 21:08 logs
20012 -rw-r--r--. 1 oracle oracle 20490624 Nov 15 17:55 newrelic.jar
[oracle@test-server-domain1-osb-server16 oracle]$ ls -ls /u01/newrelic/extensions/
total 40
4 -rw-r--r--. 1 oracle oracle 655 Nov 15 17:55 osb-adapters.jar
4 -rw-r--r--. 1 oracle oracle 654 Nov 15 17:55 osb-context.jar
4 -rw-r--r--. 1 oracle oracle 625 Nov 15 17:55 osb-http-12.2.jar
4 -rw-r--r--. 1 oracle oracle 619 Nov 15 17:55 osb-jca.jar
4 -rw-r--r--. 1 oracle oracle 650 Nov 15 17:55 osb-jms.jar
4 -rw-r--r--. 1 oracle oracle 650 Nov 15 17:55 osb-mdb.jar
4 -rw-r--r--. 1 oracle oracle 649 Nov 15 17:55 osb-mq.jar
4 -rw-r--r--. 1 oracle oracle 660 Nov 15 17:55 osb-pipeline-12.2.jar
4 -rw-r--r--. 1 oracle oracle 653 Nov 15 17:55 osb-poller.jar
4 -rw-r--r--. 1 oracle oracle 662 Nov 15 17:55 osb-transports-12.2.jar

Additional context

2021-12-07T21:08:53,004+0000 [1497 1] com.newrelic INFO: Writing to New Relic log file: /u01/newrelic/logs/newrelic_agent.log
2021-12-07T21:08:53,005+0000 [1497 1] com.newrelic INFO: JRE vendor Oracle Corporation version 1.8.0_311
2021-12-07T21:08:53,005+0000 [1497 1] com.newrelic INFO: JVM vendor Oracle Corporation Java HotSpot(TM) 64-Bit Server VM version 25.311-b25
2021-12-07T21:08:53,006+0000 [1497 1] com.newrelic INFO: OS Linux version 3.10.0-1160.42.2.el7.x86_64 arch amd64
2021-12-07T21:08:53,007+0000 [1497 1] com.newrelic INFO: Agent Host: test-server-domain1-osb-server16 IP: 10.233.73.188
2021-12-07T21:08:53,007+0000 [1497 1] com.newrelic INFO: New Relic Agent v7.1.1 is initializing...
2021-12-07T21:08:55,217+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-adapters.jar
2021-12-07T21:08:55,217+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-context.jar
2021-12-07T21:08:55,218+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-http-12.2.jar
2021-12-07T21:08:55,218+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-jca.jar
2021-12-07T21:08:55,219+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-jms.jar
2021-12-07T21:08:55,220+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-mdb.jar
2021-12-07T21:08:55,220+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-mq.jar
2021-12-07T21:08:55,221+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-pipeline-12.2.jar
2021-12-07T21:08:55,221+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-poller.jar
2021-12-07T21:08:55,222+0000 [1497 1] com.newrelic ERROR: Unable to load extension osb-transports-12.2.jar
2021-12-07T21:08:56,867+0000 [1497 10] com.newrelic INFO: Instrumentation com.newrelic.instrumentation.jdbc-resultset is disabled. Skipping.
2021-12-07T21:09:10,811+0000 [1497 1] com.newrelic.agent.RPMServiceManagerImpl INFO: Configured to connect to New Relic at collector.newrelic.com:443
2021-12-07T21:09:15,707+0000 [1497 1] com.newrelic INFO: Setting audit_mode to false
2021-12-07T21:09:16,825+0000 [1497 1] com.newrelic INFO: New Relic Agent v7.1.1 has started
2021-12-07T21:09:16,825+0000 [1497 1] com.newrelic INFO: Agent class loader: com.newrelic.bootstrap.BootstrapAgent$JVMAgentClassLoader@799f10e