When you bind an application to an instance of an applicable service, Cloud Foundry streams 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 bind.syslog_drain_url
, Loggregator identifies the associated app.syslog_drain_url
s.You can manually configure app logs to be streamed to a location of your choice using user-provided service instances.
For details, see Using Third-Party Log Management Services.