Steps to incorporate Plummb

Create a TRIAL Account

  • Click here to Sign In/Register.
  • Use Google Auth to validate yourself.
    • Provide Organization Name to create a new Account.
    • If someone has added you to an Organization, you may opt to leave/remain.
  • Download the plummb-$version.tar.gz.
    • Follow the instructions provided in ReadMe.md
    • Generate required jar file for your application.

Configuration

Configuration file, plummbAgent.properties, must be present in classpath. Recommended configuration is provided in recommendedAgent.properties.

1. Enable and Provide access key. These can be provided via export or -D parameters as well.

plummb.enabled=true
plummb.secret=$accessKey
plummb.instance.type=$instanceType (Defaults to Unknown)

            

2. Identify resources to intercept. Mostly resources should be drivers of DB, Mongo, Redis etc. It's a comma separated, regex patterns.

intercepted.packages=javax.sql.DataSource,\
  java.sql.Connection,\
  org.springframework.data.mongodb.core.MongoOperations,\
  org.springframework.jdbc.core.JdbcOperations,\
  org.springframework.data.redis.core.RedisOperations,\
  com.mongodb.DB,\
  com.mongodb.DBCollection,\
  com.mongodb.DBCursor,\
  org.apache.http.HttpMessage

            

3. Configure resource name for better management. (Defaults to PlummbAgent)

javax.sql.DataSource=SQL
java.sql.Connection=SQL
org.springframework.data.mongodb.core.MongoOperations=Mongo
org.springframework.jdbc.core.JdbcOperations=Mongo
org.springframework.data.redis.core.RedisOperations=Redis
com.mongodb.DB=Mongo
com.mongodb.DBCollection=Mongo
com.mongodb.DBCursor=Mongo
org.apache.http.HttpMessage=Http

            

Filtering (Optional)

Filtering provides an ability to apply Rules based on properties of a Context Object. This step needs code changes and mostly done at authentication layer.

4. Add an Object to the context. Fields, upto 2 levels, will be available for filtering.

ResilienceClient.setContext(object);
            

Start the application (Client)

The Client will now start communicating with Plummb.

Login to your Account

  • Enable Resilience
  • Enable Sandbox
  • Enable IP Tracking
  • Click "Clients Enabled". You should be able to see the IP Address of above configured client.
  • You are all set. Soon various Suggestions will be displayed along with other information.
  • Go ahead and create some Simulation and Resilience Rules.

Test Case for Playing

Some test cases are there to play around at the repository.

Contact Us

Email: support@plummb.com