By binding an application to an instance of an applicable service, Cloud Foundry will stream logs for the bound application to the service instance.
To enable this functionality, a service broker must implement the following:
In the catalog endpoint, the broker must include requires: syslog_drain
. This minor security measure validates that a service returning a syslog_drain_url
in response to the bind operation has also declared that it expects log streaming. If the broker does not include requires: syslog_drain
, and the bind request returns a value for syslog_drain_url
, Cloud Foundry will return an error for the bind operation.
In response to a bind request, the broker should return a value for syslog_drain_url
. The syslog URL has a scheme of syslog, syslog-tls, or https and can include a port number. For example:
"syslog_drain_url": "syslog://logs.example.com:1234"
syslog_drain_url
in response to bindsyslog_drain_url
, Loggregator identifies the associated appsyslog_drain_url
sUsers can manually configure app logs to be streamed to a location of their choice using User-provided Service Instances. For details, see Using Third-Party Log Management Services.