This is a Java client that can track and report details of a demo/tutorial that has been deployed to Cloud Foundry.

Sample web applications that include this tracking library may be configured to track deployments to IBM Bluemix and other Cloud Foundry platforms. The following information is sent to a Deployment Tracker service on each deployment by default:

• Application Name (application_name)
• Space ID (space_id)
• Application Version (application_version)
• Application URIs (application_uris)

This data is collected from the VCAP_APPLICATION environment variable in IBM Bluemix and other Cloud Foundry platforms. This data is used by IBM to track metrics around deployments of sample applications to IBM Bluemix to measure the usefulness of our examples, so that we can continuously improve the content we offer to you.

The following additional information will be sent in addition if the following are defined as described in the usage notes below:

• Source code download/issue URL (url)
• Source code version (version)

To take advantage if the tracking functionality in a web application:

1. Obtain the Cloud Foundry Java application tracker client library

• Download the client library from the Central Repository (groupId com.ibm.bluemix.deploymenttracker, artifactId cf-java-app-tracker-client) or
• Download the source code from https://github.com/IBM-Bluemix/cf-deployment-tracker-client-java and build the JAR using the default target/goal of the provided ant or pom script.

2. Copy client library cf-java-app-tracker-client-{version}.jar to your web application's WebContent/WEB-INF/lib directory.
3. Create a package.json file in the web applications' WebContent/META-INF directory. Replace the application specific information in the example below with your application's information.

 {
   "name": "talent-manager",
   "version": "1.0.0",
   "repository": {
      "type": "git",
      "url": "https://github.com/IBM-Bluemix/talent-manager.git"
   }
 }

5. Add a copy of the Privacy Notice to the README.md file.

• Note: All applications that use deploy tracker must have a Privacy Notice.

6. Package the web application.
7. Deploy the web application.

To view basic information about the tracker client and the most recent tracking request direct your browser to <APPLICATION_URL>/comibmbluemix/CFAppTracker, replacing <APPLICATION_URL> with the web application URL.

No example application is currently available.

To disable deployment tracking remove cf-java-app-tracker-client-{version}.jar from the web application's WebContent/WEB-INF/lib directory and redeploy the application.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.