Top Banner
VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Pivotal Cloud Foundry Installation & Configuration Guide
20

Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

Jun 17, 2020

Download

Documents

dariahiddleston
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR

Pivotal Cloud Foundry

Installation & Configuration Guide

Page 2: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

2 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

1. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.  Installation and Configuration Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33.  Licensing Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34.  Installing the Management Pack  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

4.1  Uploading the Installation File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44.2  Adding a License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

5.  Configuring the Blue Medora Firehose Nozzle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75.1  Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75.2 Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

6.  Configuring the Management Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106.1  Creating an Adapter Instance and Credential . . . . . . . . . . . . . . . . . . . . . . . . .106.2  Adding an SSL Certificate to the vROps Truststore. . . . . . . . . . . . . . . . . .136.3  Manually Discovering Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146.4  Validating Data Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

7.  Appendix I: Management Pack Folders and Files . . . . . . . . . . . . . . . . . . . . . . . . . . .178.  Appendix II: Webserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189.  Appendix II: Revision Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

TABLE OF CONTENTS

NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. 

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].

Page 3: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

3 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

1. Purpose

The Blue Medora VMware vRealize Operations (vROps) Management Pack for Pivotal Cloud Foundry Installation and Configuration Guide describes how to set up Blue Medora’s Management Pack for Pivotal Cloud Foundry to use within vRealize Operations.

2. Installation and Configuration Requirements

Before installing and configuring the Management Pack, ensure your system meets the following requirements:

Table 1: Management Pack System Requirements

VREALIZE OPERATIONS (VROPS) REQUIREMENTS

PIVOTAL CLOUD FOUNDRY (PCF) REQUIREMENTS

VERSION(S) vRealize Operations, v6.x(Advanced or Enterprise edition)

Pivotal Cloud Foundry 1.7+

CREDENTIALS N/A UAA User Name/Password

NOTE: The Management Pack requires a least privileged UAA user account with a minimum scope of doppler.firehose.

CONNECTION vROps hostname or IP address Pivotal Cloud Foundry hostname or IP address

The Management Pack collects data using the Blue Medora Firehose Nozzle’s REST API via default port 8081.

NOTE: The Blue Medora Firehose Nozzle must be configured prior to adding an adapter instance. Refer to section “5. Configuring the Blue Medora Firehose Nozzle” for details.

3. Licensing Requirements

When purchased individually, the Management Pack for Pivotal Cloud Foundry is licensed per OSI.

Alternatively, customers who have purchased Blue Medora’s True Visibility Suite (Standard, Advanced, or Enterprise) can access all management packs within that suite (and the edition below it, if applicable). The Management Pack for Pivotal Cloud Foundry is part of Blue Medora’s Advanced True Visibility Suite (TVS), which means a TVS Advanced license or higher is required to use it. For more information, visit http://www.bluemedora.com/true-visibility-suite-for-vmware/.

A license key will be provided by Blue Medora when the Management Pack or True Visibility Suite is purchased and must be added as a Pivotal Cloud Foundry Adapter License within vRealize Operations before the Management Pack can be configured and used. Refer to section “4.2 Adding a License Key”, for details.

Page 4: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

4 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

4. Installing the Management Pack

Installing the Management Pack in vRealize Operations involves completing the following tasks:•  Uploading the Installation File•  Adding a License Key

4.1 Uploading the Installation File

The Management Pack for Pivotal Cloud Foundry is installed by uploading a .pak file.

4.1.1 Prerequisites•  Obtain the Management Pack installation file from http://www.bluemedora.com/true-visibility-suite-for-vmware/.

•  Read the release notes that are included with the .pak file.

4.1.2 Procedure1. Save the .pak file in a temporary location.2. Log in to vRealize Operations as an admin user.3. Click the Home icon, then select the Administration navigation shortcut from the panel on the left.

Figure 1: Home > Administration

4. In the right panel, the Solutions tab will be displayed.

Figure 2: Solutions Tab

Page 5: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

5 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

5. Click the Add icon ( ) to upload the .pak file to the vRealize Operations server. In the dialog that appears, browse to the location of the saved .pak file, then click Upload.

NOTE: The .pak file upload may take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process.

Figure 3: Select the .pak file to upload

6. Click Next when the upload has finished. Read the End User License Agreement (EULA) and click the ‘I accept the terms of this agreement’ checkbox to accept, then click Next.

7. Click Finish when the installation process is complete.

NOTE: The installation utility creates the pcf_adapter3 folder and pcf_adapter3.jar file in the $VCOPS_BASE/user/plugins/inbound folder. Refer to section “7. Appendix I: Management Pack Folders and Files” for more information.

Page 6: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

4.2 Adding a License Key

The Management Pack for Pivotal Cloud Foundry requires a valid license for full operation. Complete the following steps to license the Management Pack.

4.2.1 Install the License1. In vRealize Operations Manager, navigate to Administration > Licensing > License Keys.2. Click the Add icon ( ). In the dialog that appears, select ‘Pivotal Cloud Foundry’.

Figure 4: Add License

3. Enter your Blue Medora license key, then click Validate. If successful, “License key validated successfully” will be displayed.

4. Click Save to finish adding your license key.

4.2.2 Add the License to a Group

NOTE: Adding a license to a license group is only necessary if using vROps 6.0.0. In later versions, the License will automatically be added to a group.

1. Navigate to License Groups.2. Select the license group ‘PivotalCloudFoundry Licensing’, then click the Edit icon ( ).3. Check the newly added license.4. Enter a name for this license group, then click Next.5. Select the resources to include/exclude in this group, then click Next.6. Click Finish.7. Navigate back to License Keys and click the Refresh License Usage icon ( ).

Page 7: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

7 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

5. Configuring the Blue Medora Firehose Nozzle

The Blue Medora Firehose Nozzle is a Cloud Foundry component that collects metrics for the Loggregator Firehose and exposes them via a RESTful API. Before the nozzle can be configured, it must be deployed.

There are multiple ways to deploy the nozzle:• Blue Medora Nozzle for PCF Tile method (recommended)•  Cloud Foundry Command Line Interface (cf-cli)•  Cloning from the GitHub repo and running it on any machine that can connect to the Traffic Controller•  BOSH Command Line Interface (CLI)

5.1 Prerequisites

5.1.1 Blue Medora Nozzle for PCF Tile method (recommended)•  Download the Blue Medora Nozzle for PCF Tile from the Pivotal Network at: https://network.pivotal.io/, then follow the instructions for installing, configuring, and using the nozzle as documented on the Pivotal web site at: https://docs.pivotal.io/blue-medora/index.html

5.1.2 Cloud Foundry CLI method•  Install the Cloud Foundry Command Line Interface (cf-cli) available at: https://github.com/cloudfoundry/cli

•  To deploy the nozzle, configure manifest.yml and run cf push to install the cf app as described here: https://github.com/BlueMedoraPublic/bluemedora-firehose-nozzle#deploying-as-cf-app

5.1.3 Cloning from github deployment method•  Install the Go programming language (version 1.6+) on a machine that can connect to the Traffic 

Controller•  To deploy the nozzle, run the following command, which clones the nozzle files and dependencies from the GitHub repository and sets them up them in your Go environment:

go get github.com/BlueMedoraPublic/bluemedora-firehose-nozzle

5.1.4 BOSH CLI deployment method•  Install the BOSH Command Line Interface (CLI) using the BOSH release available at: https://github.com/BlueMedoraPublic/bluemedora-firehose-nozzle-release

•  Deploy the nozzle as instructed in the following tutorial: https://docs.cloudfoundry.org/loggregator/nozzle-tutorial.html

5.2 Procedure

The following sections describe how to configure the nozzle once it has been deployed using one of the manual deployment methods listed above (5.1.2-5.1.4). For additional support, refer to the following reference material:

•  For more information on managing UAA users within Cloud Foundry, refer to the following guide: https://docs.cloudfoundry.org/adminguide/uaa-user-management.html

•  For more information on setting up a nozzle user with BOSH, refer to the following tutorial: https://docs.cloudfoundry.org/loggregator/nozzle-tutorial.html

•  For more information on setting up the BOSH manifest, refer to the following guide: https://bosh.io/docs/deployment-manifest.html

NOTE: For more information on how metrics are pulled from the Blue Medora Firehose Nozzle, refer to section “8. Appendix II: Webserver”.

Page 8: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

8 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

5.2.1 ConfiguringtheUAAUser

Ensure the Cloud Foundry UAA user you plan to use is authorizedtoaccesstheloggregatorfirehoseandhas doppler.firehose permissions. An example of one way to modify the UAA user involves editing your Cloud Foundry BOSH manifest under the properties.uaa.clients section.

An example configuration would look similar to the following:properties: uaa: clients: bluemedora-firehose-nozzle: access-token-validity: 1209600 authorized-grant-types: authorization_code,client_credentials,refresh_token override: true secret: <password> scope: openid,oauth.approvals,doppler.firehose authorities: oauth.login,doppler.firehose

5.2.2 ConfiguringtheNozzle

To configure the nozzle itself, which connects to the Cloud Foundry firehose and exposes a RESTful API, modify and re-save the configuration file, bluemedora-firehose-nozzle.json, located in the config folder of the nozzle files as follows:

Table 2: Blue Medora Firehose Nozzle Configuration Fields

FIELD DESCRIPTION

UAAURL The UAA login URL of the Cloud Foundry deployment.

UAAUsername The UAA username that has access to read from Loggregator Firehose.

UAAPassword Password for the UAA Username.

TrafficControllerURLThe URL for the Traffic Controller. To find the URL, follow the instructions outlined here: https://docs.cloudfoundry.org/loggregator/architecture.html#firehose

SubscriptionIDThe subscription ID of the nozzle. For more information about subscription IDs and nozzle scaling, refer to: https://docs.cloudfoundry.org/loggregator/log-ops-guide.html#scaling-nozzles

DisableAccessControl If true, disables authentication with UAA. Used in lattice deployments.

InsecureSSLSkipVerify If true, allows insecure connections to the UAA and Traffic Controller endpoints.

IdleTimeoutSeconds The amount of time, in seconds, the connection to the Firehose can be idle before disconnecting.

MetricCacheDurationSecondsThe amount of time, in seconds, the RESTful API web server will cache metric data. The higher this duration, the less likely the data will be correct for a certain metric as it could hold stale data.

WebServerPort Port to connect to the RESTful API (default: 8081).

Page 9: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

9 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

An example configuration would look similar to the following:{ “UAAURL”: “https://uaa.pcf.envrioment.com”, “UAAUsername”: “apps_metrics_processing”, “UAAPassword”: “password”, “TrafficControllerURL”: “wss://doppler.pcf.envrionment.com:443”, “SubscriptionID”: “bluemedora-nozzle-id”, “DisableAccessControl”: false, “InsecureSSLSkipVerify”: true, “IdleTimeoutSeconds”: 30, “MetricCacheDurationSeconds”: 60, “WebServerPort”: 8081}

5.2.3 GeneratingSSLCertificates

The Blue Medora Nozzle uses SSL for its REST webserver. In order to generate these certificates, run the following command and answer the questions at the prompts:

openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout certs/key.pem -out certs/cert.pem

5.2.4 Running the Nozzle

Once you have deployed and configured the nozzle, you can run it using the following command:

go run main.go

Page 10: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

10 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

6. Configuring the Management Pack

Configuring the Management Pack for Pivotal Cloud Foundry includes the following tasks:•  Creating an Adapter Instance and Credential•  Adding an SSL Certificate to the vROps Truststore (optional)•  Manually Discovering Resources (if necessary)•  Validating Data Collection

6.1 Creating an Adapter Instance and Credential

You must create an adapter instance and credential for the Management Pack in order to define the adapter type and identify the device(s) from which the adapter instance will retrieve data.

6.1.1 Prerequisites

Install the Management Pack for Pivotal Cloud Foundry. Refer to section “4. Installing the Management Pack”.

6.1.2 Procedure1. Log in to vRealize Operations as an administrator.2. Click on the Administration navigation shortcut ( ). The Solutions view should automatically open.3. Select the ‘Pivotal Cloud Foundry’ adapter from the Solutions list.

Figure 5: Solutions List

Page 11: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

11 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

4. Click the Configure icon ( ). The Manage Solution window will appear.

Figure 6: Manage Solution Window

NOTE: If creating multiple adapter instances, click the Add icon ( ) above the list of Instance Names on the left.

5. In the Manage Solution window, enter the following information:

Instance Settings:• Display Name: A name for this particular instance of the Management Pack• Description: Optional; most helpful for describing multiple adapter instances of the Management Pack

Basic Settings:• Host: Hostname or IP address of the Nozzle

NOTE: The Management Pack supports IPv4 and FQDN.

• Credential: Click the Add icon ( ), then enter your credential information (refer to Figure 7).

Advanced Settings:• Collectors/Groups: Automatically selected• Port: Optional; default port is 8081, but can be changed as needed to match Nozzle configuration.

(Tile / Cloud Foundry App default port: 443; BOSH Install default port: 8081)• ValidateCertificateAgainstTruststore: Optional; default setting is False (all server certificates are trusted by vROps). If set to True, the Pivotal Cloud Foundry host server SSL certificate must be added to the truststore on your vROps machine. For more information, refer to section “6.2 Adding an SSL Certificate to the vROps Truststore”.

• Support Autodiscovery: Default setting is True, which enables the adapter instance to create resources for you. If you select False, you must manually discover your Pivotal Cloud Foundry resources.

Page 12: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

12 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

Figure 7: Manage Credential Window

• Credential Name: Assign a name to your set of credentials• User Name: UAA User Name used in Nozzle configuration• Password: UAA Password used in Nozzle configuration

6. Click OK to save your credential.7. Click Test Connection to ensure vRealize Operations can connect properly to the system.8. Click Save Settings to save your adapter instance configuration.

Page 13: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

13 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

6.2 AddinganSSLCertificatetothevROpsTruststore

NOTE: Different levels of security can be configured in the Management Pack for Pivotal Cloud Foundry. The least secure configuration is to leave the default selection of False for the Validate Certificate Against Truststore Advanced Setting. For added security, you can enable SSL by following the instructions below and selecting True for the Validate Certificate Against Truststore Advanced Setting.

1. Obtain the SSL certificate for the Blue Medora Nozzle, which is stored in the certs directory of the Nozzle base directory.

2. Copy the certificate to your vROps machine.3. Use ‘ssh’ to log in to the vROps machine as the root user, then run the following command:

Linux:

$VCOPS_BASE/jre/bin/keytool -import -alias <product_alias> /tmp/<certfile> -keystore “$VCOPS_DATA_VCOPS/user/conf/ssl/tcserver.truststore” -storepass <truststore_password> -trustcacerts

Windows:

%VCOPS_BASE%\jre\bin\keytool -import -alias <product_alias> C:\path\to\certfile -keystore “%VCOPS_DATA_VCOPS%\user\conf\ssl\tcserver.truststore” -storepass <truststore_password> -trustcacerts

NOTE: The <truststore_password> is generated by vROps and is located in /storage/vcops/user/conf/ssl/storePass.properties. Copy the password from the ssltruststorePassword= field and paste it in the <truststore_password> placeholder.

Parameter Descriptions:

-alias is a unique name for each key that you add (per host)certfile is the location where the cert file was saved

4. Run the reboot command to re-start the vROps machine for the changes to take effect.

Page 14: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

14 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

6.3 Manually Discovering Resources

If Autodiscovery was set to False when configuring the adapter instance, you will need to manually discover resources as described in this section. With manual discovery, the adapter sends a request to the Pivotal Cloud Foundry system to return resources, which you then manually select to import into vRealize Operations.

6.3.1 Prerequisites

Create a Pivotal Cloud Foundry adapter instance and credential. Refer to section, “6.1 Creating an Adapter Instance and Credential”, for details.

6.3.2 Procedure1. Log in to vRealize Operations as an administrator.2. Click the Administration navigation shortcut ( ).3. Click Environment Overview (Inventory Explorer in vROps 6.1+) in the navigator pane.

Figure 8: Environment Overview (Inventory Explorer) > Adapter Instances

4. Under Adapter Instances, select ‘Pivotal Cloud Foundry Adapter Instance’.

Page 15: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

15 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

5. Click the Discover Resources icon ( ) to open the Discover Objects window.

Figure 9: Discover Objects Window

6. In the Discover Objects window, select the following information:•  The Collector to use

NOTE: Unless you added additional collectors, the only available collector is your vROps server.

•  ‘Pivotal Cloud Foundry’ for Adapter Type•  The applicable Adapter Instance•  ‘Pivotal Cloud Foundry Discovery’ for Discovery Info•  Whether Only New Objects (select/de-select checkbox) should be collected

7. Click OK to start the discovery process.8. The discovery process can take several seconds to several minutes. When it has finished, the Discovery

Results window lists your resources.9. Double-click each resource kind that contains resources to add.10. Select options for each kind of resource. Refer to Table 3.

Table 3: Resource Options

OPTION DESCRIPTION

Import Import the resources but do not start collecting data. Resources appear in the resource list as Not Collecting; data is not stored; analysis is not performed.

Collect Import the resources and start collecting data. When you select the Collect check box, the Import check box is also selected.

11. Click OK. The Discovery Results window closes and the new resources appear.

6.3.3 What To Do Next

If you did not select the option to start metric collection when you defined a resource, you can start metric collection after the resource is defined. To start collecting metrics for a resource, choose the resources, then click the Start Collecting icon ( ).

Page 16: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

16 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

6.4 Validating Data Collection

After you add an adapter instance, you will want to validate the data that it collects in vRealize Operations.

6.4.1 Prerequisites

Add a Pivotal Cloud Foundry adapter instance. Refer to section “6.1 Creating an Adapter Instance and Credential”, for details.

6.4.2 Procedure1. Select the Environment shortcut.

NOTE: If you enabled Autodiscovery for the adapter instance, it will create resources as soon as it begins collecting metrics. If you disabled Autodiscovery for the adapter instance, you must go back and discover resources manually before you can validate data collection. Refer to section “6.3 Manually Discovering Resources”.

2. Under Inventory Trees, select All Objects, then expand the Pivotal Cloud Foundry objects list.3. Select a resource from the list, then click the Troubleshooting tab and All Metrics view to validate values 

against the data source.

Figure 10: Pivotal Cloud Foundry Adapter Objects Troubleshooting

Page 17: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

17 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

7. Appendix I: Management Pack Folders and Files

The installer places the Management Pack files in the pcf_adapter3 folder under the $VCOPS_BASE/user/plugins/inbound folder as shown below.

Table 4: Management Pack Folders and Files

FOLDER FILE DESCRIPTION

conf #_PCF_ADAPTER_max_observations.moar Tracks ‘Max Observed’ metrics for the adapter instance

dashboards (folder) Contains .json files for Management Pack Dashboards

describe.xml Describes the Management Pack

describeSchema.xsd Used to validate describe.xml

historical.properties Used to enable historical mode. Allows the adapter to backfill data if collection is interrupted for any reason.

images (folder) Contains .png files for AdapterKind, ResourceKinds, and TraversalSpec

license.properties Contains back-up copy of licenses used for this Management Pack

oss_attribution.txt Describes open source libraries used by the Management Pack

pcf.properties Contains properties that can be modified to adjust adapter operation

reports (folder) Contains .xml files for Management Pack Reports

reskndmetrics (folder) Contains .xml files for Dashboard Metric configuration

resources (folder) Contains resources.properties file

scripts (folder) Contains .sdm files consumed by the Management Pack 

version.txt Contains version information

lib Refer to lib folder for entire list .jar files that contain the classes and resources used to implement the Management Pack

work install.log

lastcollection.properties Tracks when the last collection for each adapter instance was performed (used when historic mode is enabled)

Page 18: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

18 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

8. Appendix II: Webserver The webserver is how metrics are pulled out of the Blue Medora Firehose Nozzle. It provides a RESTful API that requires an authentication token.

Token RequestA token can be requested from the /token endpoint. A token times out after 60 seconds. In order to request a token, send a GET request with the two header pairs username and password with values that correspond to the UAA user in the bluemedora-firehose-nozzle.json config file. If a successful login occurs, the response will contain a header pair of token and the value will be your token. 

Metric EndpointsOnce a valid token is acquired, a GET request with the header pair token and value of your token can be sent to one of the following endpoints:

• /metron_agents• /syslog_drains• /tps_watchers• /tps_listeners• /stagers• /ssh_proxies• /senders• /route_emitters• /reps• /receptors• /nsync_listeners• /nsync_bulkers• /garden_linuxs• /file_servers• /fetchers• /convergers• /cc_uploaders• /bbs• /auctioneers• /etcds• /doppler_servers• /cloud_controllers• /traffic_controllers• /gorouters

A JSON response will be sent in the following form:[ { “Deployment”:”deployment_name”, “Job”:”job_name”, “Index”:”0”, “IP”:”X.X.X.X”, “ValueMetrics”:{ “MetricName”:integer_value, “MetricName”:integer_value }, “CounterMetrics”:{ “MetricName”:integer_value, “MetricName”:integer_value } }]

NOTE: Counter metrics are reported as totals over time. The consumer must take the delta between two totals to get the current value as time changes.

Page 19: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

19 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide

9. Appendix II: Revision Notes

This installation guide is updated with each release of the product, or when necessary. The following table provides its revision history.

REVISION DATE DESCRIPTION

REV-06 08-JUN-2017 •  Updated System Requirements to indicate support for PCF versions 1.7 and above.

REV-05 14-FEB-2017 •  Updated section “6.2 Adding an SSL Certificate to the vROps Truststore” to include Windows instructions

REV-04 08-FEB-2017 •  Updated Blue Medora GitHub links

REV-03 24-JAN-2017•  Added default port information for PCF Tile, Cloud Foundry App, and BOSH Install to the Port Advanced Setting description in section “6.1 Creating an Adapter Instance and Credential”.

REV-02 30-NOV-2016•  Added information to section “5. Configuring the Blue Medora Firehose

Nozzle”about the recommended Blue Medora Nozzle for PCF Tile method for deploying the Blue Medora Firehose Nozzle.

REV-01 23-SEP-2016 Initial release

Page 20: Installation & Configuration Guide - Blue Medora€¦ · 6 Blue Medora VMware vRealize Operations Management Pack for Pivotal Cloud Foundry Installation & Configuration Guide 4.2

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you  have comments about this documentation, submit your feedback to:  [email protected].

Copyright © 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions.

The Pivotal name (including Pivotal Cloud Foundry) and logo are trademarks or registered trademarks of Pivotal Software, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

Blue Medora3225 N Evergreen Dr. NE Suite 103Grand Rapids, MI 49525

www.bluemedora.com