Giter Club home page Giter Club logo

agent-wso2-esb's Introduction

WSO2 ESB mediator for Aino.io

Build status

WSO2 ESB mediator implementation of Aino.io logging agent.

What is Aino.io and what does this Agent have to do with it?

Aino.io is an analytics and monitoring tool for integrated enterprise applications and digital business processes. Aino.io can help organizations manage, develop, and run the digital parts of their day-to-day business. Read more from our web pages.

Aino.io works by analyzing transactions between enterprise applications and other pieces of software. This Agent helps to store data about the transactions to Aino.io platform using Aino.io Data API (version 2.0). See API documentation for detailed information about the API.

Technical requirements

  • Oracle Java 7
  • WSO2 ESB (Tested with 4.7.0, 4.8.X and 4.9.0)

Example usage

Before using the agent, it must be configured and copied to directory where ESB can find it. After installing and configuring, the agent can be used with ainoLog mediator.

1.1 Add as Maven/Gradle/Ivy dependency

Get the dependency snippet from here.

1.2 Install the mediator

Copy the AgentWso2ESB-x.y.jar to $WSO2_ESB_HOME/repository/components/dropins/.

2. Configuring the agent

As WSO2 ESB agent uses Java agent, it must be configured according to Java Agent Configuration. Java agent configuration should be in $WSO2_ESB_HOME/repository/conf/ainoLogMediatorConfig.xml, where $WSO2_ESB_HOME is your WSO2 ESB installation directory.

Additionally, one configured 'application' must have key esb.

3. Add Aino.io certificate to WSO2 ESB

Export certificate

This instruction is for Chrome browser so if you are using another browser, please google how to export a ssl certificate from a site with your browser.

Open the site in the Chrome browser, and then click the small lock icon beside the URL in the address bar. Press Details and the developer toolbar opens in the lower part of the browser. Press View certificate. In the popup drag from the certificate icon and drop the certificate to the folder $WSO2_ESB_HOME/repository/resources/security/. A file named *.aino.io.cer was created.

Import it to the keystore

Then import the created *.cer file to the keystore. Check the current keystore password from $WSO2_ESB_HOME/repository/conf/axis2/axis2.xml (search for parameter called "truststore"). Then run command and give the password:

keytool -import -alias aino.io   -file *.aino.io.cer -keystore client-truststore.jks

4. Send a request to Aino.io:

Minimal example (only required fields)

<ainoLog status="success">
    <to applicationKey="app02" />
</ainoLog>

Only from or to field is allowed, as the mediator automatically sets the other to esb.

Full example

<ainoLog status="success">
    <operation key="update" />
    <message value="success" />
    <ids expression="//order/orderId" typeKey="dataType01" />
    <ids expression="//order/customerId" typeKey="dataType02" />
    <to applicationKey="app02" />
    <payloadType key="subInterface01" />
    <!-- Property fields can be used to send additional information (showed in metadata section in Aino.io)-->
    <property expression="//someXpath" name="someProp" />
    <property expression="//someOtherXpath" name="someOtherProp" />
    <property expression="//someThirdXpath" name="someThirdProp" />
</ainoLog>

All 'keys' must match keys configured in Aino configuration file. Please note that the order of the configuration elements (child elements of ainoLog) must be as specified above (at least for now).

Contributing

Technical requirements

  • Java 7
  • Maven 3.X
  • WSO2 ESB

Contributors

Copyright © 2016 Aino.io. Licensed under the Apache 2.0 License.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.