diff --git a/services/log-management.html.md.erb b/services/log-management.html.md.erb index 2809490a..cb62d88d 100644 --- a/services/log-management.html.md.erb +++ b/services/log-management.html.md.erb @@ -68,7 +68,7 @@ You can create a syslog drain service and bind apps to it using Cloud Foundry Co
SYSLOG-DRAIN-URL is the syslog URL from Step 1: Configure the Log Management Service.
$ cf create-user-provided-service DRAIN-NAME -l SYSLOG-URL?drain-data=DRAIN-DATA-VALUE
@@ -124,6 +124,22 @@ You can create a syslog drain service and bind apps to it using Cloud Foundry Co
$ cf create-user-provided-service DRAIN-NAME -l SYSLOG-URL -p '{"ca":"-----BEGIN CERTIFICATE-----\nMIIH...-----END CERTIFICATE-----", "cert":"-----BEGIN CERTIFICATE-----\nMIIH...-----END CERTIFICATE-----","key":"-----BEGIN PRIVATE KEY-----\nMIIE...-----END PRIVATE KEY-----"}'
+ When setting up your syslog drain, it is important to choose the correct scheme for your SYSLOG-URL:
+
+ * Use the syslog-tls scheme for endpoints that require TLS or mTLS.
+ * Use the syslog scheme for endpoints that do not require TLS.
+ * Use the https scheme when shipping logs to an HTTPS endpoint.
+
+ If you need to use TLS or mTLS, ensure that you provide the necessary CA certificate. Additionally to the CA certificate for mTLS configuration, both the client certificate and the key must be provided.
+
+ Ensure that certificates and keys are PEM-encoded as specified in RFC-1422. They should be provided as string values, with new lines represented by the `\n` character, and must not have trailing new lines. You can convert a PEM-encoded certificate string to a processable format using the following command:
+
+
+ $ awk 'NF {sub(/\r/, ""); printf "%s\\n",$0;}' cert.pem | sed 's/\\n$//' | tr -d '\n'
+
+
+ The `cf create-user-provided-service` command accepts any JSON payload without validating the certificates or credentials while creating the syslog drain. There is no error message for wrong certificates or credentials in the cf CLI; you can only validate in your target log service if your syslog drain was configured correctly. To troubleshoot your certificates, you can use the openssl command line tool.
+
For more information, see [User-provided service instances](./user-provided.html).
2. To bind an app to the service instance, do one of these: