When trying to setup the logback.xml and get the process data context from MDC it was unclear what exactly has to be done for "LoggingContextBusinessKey".
The following questions arose from our consultants:
To which value and where do I need to set the parameter "loggingContextBusinessKey" in order to make it available within the log output?
Can it be handled as generic property and set within the application.yaml?
Do I need to specify it within the processes.xml?
It is specified as String value in the actual implementation - to which value do I need to set it? "true" / var name "businessKey" or smth. else?
Once that's clarified, I'd vote for making this sentence in the docs more understandable:
"The specified data will only be put into the MDC if a key is defined." maybe something like this"The specified data will only be put into the MDC if a key is defined in the application.yaml or the bpm-platform.xml file." and then provide some examples (application.yaml, Processes.xml, BPM-Platform.xml). like this one
application.yaml file I needed to add this:
camunda:
bpm:
generic-properties:
properties:
loggingContextBusinessKey: businessKey #This is key name that will show up in the log file.
So would someone be able to change the wording and add some examples to make this clearer? If two of our own consultants are having an issue then it's probably not clear for a customer either.
This issue was imported from JIRA:
When trying to setup the logback.xml and get the process data context from MDC it was unclear what exactly has to be done for "LoggingContextBusinessKey".
The following questions arose from our consultants:
When trying to embed the business key into the MDC which is set per default to null as shown here: https://docs.camunda.org/manual/latest/reference/deployment-descriptors/tags/process-engine/#logging-context-parameters
To which value and where do I need to set the parameter "loggingContextBusinessKey" in order to make it available within the log output?
Once that's clarified, I'd vote for making this sentence in the docs more understandable:
"The specified data will only be put into the MDC if a key is defined." maybe something like this"The specified data will only be put into the MDC if a key is defined in the application.yaml or the bpm-platform.xml file." and then provide some examples (application.yaml, Processes.xml, BPM-Platform.xml). like this one
application.yaml file I needed to add this:
So would someone be able to change the wording and add some examples to make this clearer? If two of our own consultants are having an issue then it's probably not clear for a customer either.
Acceptance Criteria (Required on creation):
Hints (Optional):
Links: