Table of Contents

Getting Started with Driven Beta

version 1.2


Driven is a web-based application performance management platform that helps you visualize the operational details around all phases of your data-processing applications: development, debugging, performance tuning, and operator monitoring.

To enable Driven, you must install the Driven Plugin in your Hadoop environment to process telemetry data from your running applications. You do not need to make any changes to your existing data applications to integrate with Driven.

The simplest way to get started is by using the online hosted service for Driven without signing up for an account, which allows you to try out the product anonymously. After enabling Driven anonymously and using some features, sign up for a Driven Beta account and get an API key. With the API key, you can enable the Driven Plugin to provide more features, such as performance timelines of application runs.


Your applications must have network access to using the standard port 443. Neither Cascading nor the plugin opens a connection from a Hadoop cluster. Note that the client side of Cascading will be the only Java process attempting to make a remote network connection.

Installing the Driven Plugin

Using Driven

Once plugin installation completes, you can view application performance metrics in Driven. Run your Cascading application as you would normally. When the application starts, a message in the console output appears with a link to view the application on the Driven server:

    ________        __    ________        .__
   /  _____/  _____/  |_  \______ \_______|__|__  __ ____   ____
  /   \  ____/ __ \   __\  |    |  \_  __ \  \  \/ // __ \ /    \
  \    \_\  \  ___/|  |    |    `   \  | \/  |\   /\  ___/|   |  \
   \______  /\_____>__|   /_______  /__|  |__| \_/  \_____>___|  /
          \/                      \/                           \/ ©

  Follow this link to view your application:

  http://localhost:8080/driven/[your app ID]

After opening a Driven web page, you can open the same URL to view data about the same application at any time.

Whenever Cascading is executed, the running application is given a random unique application ID (app ID). This ID uniquely identifies your application instance.

The full banner is not displayed after you configure the plugin with an API key that is generated by registering for a Driven account.

To run Driven with additional features, such as team-sharing and performance timelines of application runs, see Enabling the Driven Beta API.

Troubleshooting and Getting Support

The Troubleshooting documentation addresses some issues that you might encounter with Driven, such as what to do if the plugin runs out of memory after installation.

Support for Driven is provided via a public forum:

or by email: