Installing the Loggregator Firehose Plugin for cf CLI
Page last updated:
Warning: Pivotal Cloud Foundry (PCF) v2.4 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.
Page last updated:
The Loggregator Firehose plugin for the Cloud Foundry Command Line Interface (cf CLI) allows Cloud Foundry (CF) administrators to access the output of the Loggregator Firehose. The output of the Firehose includes logs and metrics from apps deployed on CF as well as metrics from CF platform components. For more information about the Firehose, see Overview of the Loggregator System.
For more information about using plugins with the cf CLI, see Using cf CLI Plugins.
- Administrator access to the Cloud Foundry deployment that you want to monitor
- Cloud Foundry Command Line Interface (cf CLI) 6.12.2 or later
Refer to the Installing the cf CLI topic for information about downloading, installing, and uninstalling the cf CLI.
cf add-plugin-repo REPOSITORY-NAME URLto add the CF Community plugin repository to your cf CLI plugins.
$ cf add-plugin-repo CF-Community https://plugins.cloudfoundry.org
cf install-plugin -r PLUGIN-REPOSITORY PLUGIN-NAMEto install the Firehose plugin from the CF Community plugin repository.
$ cf install-plugin -r CF-Community "Firehose Plugin"
cf nozzle --debug to view the streaming output of the Firehose, which includes logging events and metrics from CF system components. For more information about logging and metrics in CF, see Overview of the Loggregator System.
$ cf nozzle --debug
Note: You must be logged in as a Cloud Foundry administrator to access the Firehose.
cf plugins to 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
cf uninstall-plugin PLUGIN-NAME to uninstall the plugin.
$ cf uninstall-plugin FirehosePlugin