Installing the Loggregator Firehose Plugin for cf CLI
Page last updated:
Warning: Pivotal Application Service (PAS) v2.8 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.
This topic describes how to install the Loggregator Firehose Plugin for the Cloud Foundry Command Line Interface (cf CLI).
The Loggregator Firehose plugin for the cf CLI allows Pivotal Application Service (PAS) admins to access the output of the Loggregator Firehose. The output of the Firehose includes logs and metrics from apps deployed on PAS as well as metrics from PAS platform components. For more information about the Firehose, see the Loggregator Architecture section of the Loggregator Architecture topic.
For more information about using plugins with the cf CLI, see Using cf CLI Plugins.
Note: You can disable the Firehose. In place of the Firehose, you can configure an aggregate log and metric drain for your foundation. For more information, see Configure System Logging in Configuring PAS.
Before installing the Loggregator Firehose plugin, you need:
Admin access to the PAS deployment that you want to monitor
Cloud Foundry Command Line Interface (cf CLI) v6.12.2 or later
For information about downloading, installing, and uninstalling the cf CLI, see Installing the cf CLI.
To install the Loggregator Firehose plugin:
Add the CF Community plugin repository to your cf CLI plugins by running:
cf add-plugin-repo CF-Community https://plugins.cloudfoundry.org
Install the Firehose plugin from the CF Community plugin repository by running:
cf install-plugin -r CF-Community "Firehose Plugin"
To view the streaming output of the Firehose, which includes logging events and metrics from PAS system components, run:
cf nozzle --debug
Note: You must be logged in as a PAS admin to access the Firehose.
For more information about logging and metrics in PAS, see Loggregator Architecture.
To uninstall the Loggregator Firehose plugin:
cf pluginsto see a list of installed plugins.
$ cf plugins Listing Installed Plugins... OK Plugin Name Version Command Name Command Help FirehosePlugin 0.6.0 nozzle Command to print out messages from the firehose
Uninstall the plugin by running:
cf uninstall-plugin FirehosePlugin