What is it?

• Message format: The format used when logging client requests and server responses. Valid values are SIMPLE or JSON format. The SIMPLE format does not add quotation marks around field names and does not encode the content data if it is not JSON.
• Multi-line logging: When message logging is enabled, the log record includes such fields as timestamp, host, and remote address, in addition to the content in the client request or server response. This data can be logged over multiple lines (one field per line) or on a single line.
• Log response: Indicates whether the response should be logged or not.
• Content limit: The maximum size of the content to log. If a message exceeds the size, the message is not logged. A value of -1 (*NOMAX) indicates that there is no limit. A value of zero indicates that the content should not be logged. When the content is not logged because the size exceeds the specified limit, you will see a value of 'NOT-LOGGED-SIZE' corresponding to the content field in the log record.
• HTTP header filter: A list of comma-delimited HTTP headers for which the values will not be logged. If the header has a value, it will be replaced by the following string: 'REDACTED'. A value of '*NONE' indicates that all HTTP headers are to be logged without modification. A value of '*ALL' indicates that HTTP headers are not to be logged. Note that HTTP headers are case-insensitive. The filter may contain generic names. A generic name is a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, all headers that have names with the same prefix as the generic name will not be logged.
• HTTP parameter filter: A list of comma-delimited HTTP parameters for which the values will not be logged. HTTP parameters include query string parameters and form parameters and are case-sensitive unless the Case-sensitive filter is set to false. If the HTTP parameter has a value, it will be replaced by the following string: 'REDACTED'. A value of '*NONE' indicates that all HTTP parameters are to be logged without modification. A value of '*ALL' indicates that HTTP parameters are not to be logged. In addition, if the client request contains query string data or form data and the HTTP parameter filter is set to not log HTTP parameters, the value 'NOT-LOGGED-REDACTED' corresponding to the content field and query string field in the log record will be used. The filter may contain generic names. A generic name is a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, all parameters that have names with the same prefix as the generic name will not be logged.
• Case-sensitive filter: Specify whether HTTP parameter names should be treated as case-sensitive or not case-sensitive when HTTP parameter filtering is performed.
• Select services for message logging: Select the web services for which messages will be logged.

{
type: liberty_ibmihttpmessagelog,
host: HOST52P12,
ibm_flow: request,
ibm_datetime: 2022-03-27T19:36:59.338,
ibm_correlation: 0000000008052_1648427819337,
ibm_remoteIP: 10.10.220.148,
ibm_remoteUserID: null,
ibm_requestMethod: GET,
ibm_requestHost: HOST52P12.ibm.com,
ibm_requestPort: 10000,
ibm_uriPath: /web/services/QIWSSAMPLE,
ibm_queryString: null,
ibm_contentType: null,
ibm_headers: { 
  Accept: ["text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"], 
  Accept-Encoding: ["gzip, deflate"], 
  Accept-Language: ["en-US,en;q=0.9"], 
  Connection: ["keep-alive"], 
  Cookie: ["REDACTED"], 
  Host: ["HOST52P12.ibm.com:10000"], 
  Upgrade-Insecure-Requests: ["1"], 
  User-Agent: ["Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"]
},
ibm_messageBodyLength: 0,
ibm_messageBody: null
}

{
type: liberty_ibmihttpmessagelog,
host: HOST52P12,
ibm_flow: response,
ibm_datetime: 2022-03-27T19:36:59.343,
ibm_correlation: 0000000008052_1648427819337,
ibm_contentType: application/json;charset=utf-8,
ibm_headers: { 
  Content-Type: ["application/json;charset=utf-8"]
},
ibm_responseCode: 200,
ibm_messageBodyLength: 19,
ibm_messageBody: {"TEMPOUT":"-4.99"}
}

{
"type": "liberty_ibmihttpmessagelog",
"host": "HOST52P12",
"ibm_flow": "request",
"ibm_datetime": "2022-03-27T19:49:47.527",
"ibm_correlation": "0000000000071_1648428587509",
"ibm_remoteIP": "10.10.220.148",
"ibm_remoteUserID": null,
"ibm_requestMethod": "GET",
"ibm_requestHost": "HOST52P12.ibm.com",
"ibm_requestPort": "10000",
"ibm_uriPath": "/web/services/QIWSSAMPLE",
"ibm_queryString": null,
"ibm_contentType": null,
"ibm_headers": { 
  "Accept": ["text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"], 
  "Accept-Encoding": ["gzip, deflate"], 
  "Accept-Language": ["en-US,en;q=0.9"], 
  "Connection": ["keep-alive"], 
  "Cookie": ["REDACTED"], 
  "Host": ["HOST52P12.ibm.com:10000"], 
  "Upgrade-Insecure-Requests": ["1"], 
  "User-Agent": ["Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"]
},
"ibm_messageBodyLength": 0,
"ibm_messageBody": null
}

{
"type": "liberty_ibmihttpmessagelog",
"host": "HOST52P12",
"ibm_flow": "response",
"ibm_datetime": "2022-03-27T19:49:48.147",
"ibm_correlation": "0000000000071_1648428587509",
"ibm_contentType": "application/json;charset=utf-8",
"ibm_headers": { 
  "Content-Type": ["application/json;charset=utf-8"]
},
"ibm_responseCode": 200,
"ibm_messageBodyLength": 19,
"ibm_messageBody": "{\"TEMPOUT\":\"-4.99\"}"
}

Why use it?

Availability

The support is enabled in the following HTTP group PTFs and PTFs:

V7R3M0 SF99722 Level 38
V7R4M0 SF99662 Level 19