Installing PCF Application Watchdog

This topic describes how to install, configure, and manage Pivotal Cloud Foundry (PCF) Application Watchdog.

Install and Configure PCF Application Watchdog

Perform the following steps to install and configure PCF Application Watchdog.

Step 1: Add the PCF Application Watchdog Tile to Ops Manager

  1. Download the PCF Application Watchdog tile from Pivotal Network.

    Note: Because the PCF Application Watchdog is currently in an internal beta, you may not be able to download the tile from Pivotal Network.

  2. Upload the PCF Application Watchdog tile to your Ops Manager installation by clicking Import a Product.
  3. Click the + sign next to the uploaded product description on the left hand column of Ops Manager to add PCF Application Watchdog to your Installation Dashboard.

Step 2: Configure the PCF Application Watchdog Tile

  1. From the Installation Dashboard, click the PCF Application Watchdog tile. The tile appears orange when it requires configuration.

  2. Click MySQL Settings. MySQL Settings Under Service plans to use for the MySQL, enter the name of the MySQL service plan you want to use for PCF Application Watchdog. You can retrieve the names of your MySQL service plans in one of the following ways:

    • Navigate to the Ops Manager Installation Dashboard and click the MySQL for Pivotal Cloud Foundry tile. Click Service Plans.
    • Log in to your PCF deployment with the Cloud Foundry Command Line Interface (cf CLI) and run cf marketplace -s p-mysql.
  3. Click Save.

Step 3: Deploy PCF Application Watchdog

  1. Return to the Ops Manager Installation Dashboard.
  2. Click Apply Changes to install the service. Review the Using PCF Application Watchdog topic for more information on how to connect, use, and interpret data from PCF Application Watchdog.

Manage PCF Application Watchdog

The following sections contain information about how to manage PCF Application Watchdog.

Scale Instances

By default, PCF Application Watchdog deploys one server instance with 1.5GB of memory, and four worker instances with 2GB of memory each to the system org and appdog space.

To increase the number of server or worker instances, perform the following steps:

  1. Target the PCF Application Watchdog space:
    $ cf target -o system -s appdog
  2. Scale up the PCF Application Watchdog app to the desired number of instances. The example below scales the app to 8 instances:

    $ cf scale -i 8 appdog-worker

    Note: Every time the deploy errand runs, it resets the instance number and memory size for the PCF Application Watchdog server and workers to the default values.

Use the Healthcheck Endpoint

If you are encountering problems with PCF Application Watchdog, try to load the /health endpoint on the PCF Application Watchdog server. For example, run the following curl command:

$ curl https://appdog-server.example.com
{"health":{"uaa":true,"workers":true,"db":true,"daily_scan_time":true}}

Each key gives a true or false value based on whether that component of PCF Application Watchdog is functioning correctly.

Understand Errands

PCF Application Watchdog includes three errands:

  • The deploy errand pushes the PCF Application Watchdog server and worker to the system org and appdog space, creates a UAA client, and creates a MySQL for Pivotal Cloud Foundry database instance.
  • The smoke test errand ensures that the health-check endpoint is returning true for all required components and verifies that PCF Application Watchdog has successfully scanned itself.
  • The delete errand destroys the appdog space and deletes the PCF Application Watchdog database instance and UAA client.
Create a pull request or raise an issue on the source for this page in GitHub