Cloud Foundry and Pivotal Platform

Supported Versions

Pivotal Platform:

Tile Version
Pivotal Application Service (PAS) 2.3 through 2.7
Pivotal Container Service (PKS) (Technical preview) 1.5 and above
MySQL for Pivotal Platform 2.5.3 and above
RabbitMQ for Pivotal Platform 1.17.0 and above
Redis for Pivotal Platform 2.0.0 and above

Cloud Foundry and BOSH:

  • cf-deployment v3.0 and above
  • BOSH directors version v255.4 and above

Supported Stemcells

Configuration

The Instana Agent can be installed as a tile, if you use Pivotal Platform (formerly known as Pivotal Cloud Foundry) or as BOSH release for open-source Cloud Foundry or other BOSH-based deployments.

Infrastructure Map

Hosts and containers in a Cloud Foundry or Pivotal Platform foundation are discovered automatically and displayed in the infrastructure map. For further narrowing down the entities the cloud foundry support added filters for entity.cloudfoundry.organization (name and id), entity.cloudfoundry.space (name and id) and entity.cloudfoundry.application (name and id). Additionally, the Garden containers can be grouped by Cloud Foundry Application and Cloud Foundry Space:

Garden Containters of Cloud Foundry Applications

On the infrastructure map, all the available facilities for Kubernetes are also available for Kubernetes clusters deployed via PKS. For more information, see our Kubernetes documentation.

Garden Containers

Garden containers have dedicated dashboards. See the Garden documentation for more information.

Monitoring BOSH Agent, Gorouter and other important processes

Note: The Instana Microservices Application Monitoring for Pivotal Platform tile version 1.168.x and above is required to access this functionality.

Instana automatically monitors out-of-the-box CPU, memory, and file descriptor consumption of notable processes in the Cloud Foundry and Kubernetes control plane, specifically:

  • BOSH agent
  • BOSH DNS
  • Gorouter
  • Cloud Controller
  • kube-apiserver
  • kube-controller-manager
  • kube-scheduler

A Gorouter process monitored out-of-the-box by Instana

Kubernetes Dashboards for PKS

With PKS, the Kubernetes clusters created via the PKS API are displayed in the Kubernetes section of Instana. Master nodes also get instrumented and can be found in the Infrastructure map alongside their sibling worker nodes.

For more information on how Instana monitors Kubernetes, see our Kubernetes documentation.

Cloud Foundry Dashboards

Note: This section describes a functionality that is currently in Technical Preview. Please reach out to support to request access.

Note: Accessing this functionality requires the Instana Microservices Application Monitoring for Pivotal Platform tile version 1.161.x and above.

Cloud Foundry is an important and distinct part of your overall application stack. To encompass this importance Instana has dedicated support for Cloud Foundry applications. This starts by its own dedicated top-level element in the Instana UI which makes it easily accessible and easy to understand for Cloud Foundry users. At the same time all information is deeply linked via the Dynamic Graph into other product areas like Infrastructure, Application Perspectives, and Analyze.

Listing Applications

By default Instana lists all application it detects from all reporting clusters. The applications are easily searchable or sortable by the most relevant information like state, organization or space:

Listing Cloud Foundry Applications

Application Dashboard

The Cloud Foundry Application dashboard contains the most important information for an application to check for the status and any problems. It lists the Garden containers that this application is made of and links to a detailed Garden Container dashboard. It also provdes access to all calls to this application via the Analyze Calls button.

Cloud Foundry Application Dashboard

Discovering Managed Services

The Instana agents deployed across the foundation detect and monitor the services running on them. Services created by some tiles are automatically monitored, with the Instana agent detecting the credentials and settings, see the Supported Versions section.

Services that are not automatically monitored, can be configured manually via the custom agent configuration facilities of the Instana tile.

If there are tiles or BOSH releases you would like to see configured automatically, let us know by opening a feature request in our support portal.

BOSH Integrations

Based on the data available from the BOSH Director, the Instana offers a lot of automation.

Automatic Maintenance Windows for BOSH deployments

Note: The Instana Microservices Application Monitoring for Pivotal Platform tile version 1.168.x and above is required to access this functionality.

The Instana tile automatically detects BOSH deployments running across the Pivotal Platform foundation and creates, schedule, and unschedule maintenance windows.

For more information on this feature, see our Maintenance Windows documentation.

The “Automatic Maintenance Windows” feature of the tile requires the following configurations:

  • Backend connection > API endpoint URL: must point to your tenant unit in Instana.
  • Backend connection > API token: requires an API token with, at least, the Configuration of custom alerts permission. For more information, see our API Tokens documentation.

To deactivate the Automatic Maintenance Windows functionality, select the Agent automatic configurations > Automatic maintenance windows for BOSH option in the tile configuration.

To roll out the change, select Apply Changes in OpsManager for the Pivotal Application Service (PAS) or Pivotal Container Service (PKS) tile.

Pipeline Feedback for BOSH deployments

Note: The Instana Microservices Application Monitoring for Pivotal Platform tile version 1.166.1 and above is required to access this functionality.

Important: The status of the Pipeline Feedback functionality is currently experimental. In foundations with many service instances, each of which usually has a a dedicated BOSH deployment, it may become a bit too chatty. Let us know what you think of it!

The Instana tile automatically detects BOSH deployments running across the Pivotal Platform foundation, and as part of the Pipeline Feedback functionality within Instana, these deployments are reported as releases.

For more information, see our Pipeline Feedback documentation.

To opt-in to the “Pipeline Feedback for BOSH deployments” feature, activate the Agent automatic configurations > [Experimental] Pipeline Feedback for BOSH option within the Instana tile configurations in OpsManager.

Make sure to configure the following settings correctly:

  • Backend connection > API endpoint URL: must point to your tenant unit in Instana.
  • Backend connection > API token: requires an API token with, at least, the Configuration of releases permission. For more information, see our API Tokens documentation.

To roll out the change, select Apply Changes in OpsManager for the Pivotal Application Service (PAS) or Pivotal Container Service (PKS) tile.