Action: Log Invocation
This action logs request/response payloads. You can log the payloads in the database and/or send the payloads in the form of email alerts. This action also logs other information about the request/response, including the service name, operation name, the Integration Server user, a timestamp, the response time, and more.
General Data Protection Regulation (GDPR) considerations
As part of this policy action, all request/response payloads are logged in the database or can be sent in the form of email alerts. Depending on the SaaS provider requirements, some of the logged data may be personal data or personally identifiable information. If for privacy concerns or to be in compliance with General Data Protection Regulation (GDPR), you want to delete the personal data of a user, you can manage the personally identifiable information by purging it from the database.
The database used by CloudStreams has the following tables which contain request/response payloads or such information of interest. To purge the data along with the table names, the following field/column names are provided using which the data can be cleaned up.
CLS_TXN_EVENT
REQUEST
RESPONSE
CONSUMER_IP
CLS_ERR_EVENT
CONSUMER_IP
CLS_PV_EVENT
CONSUMER_IP
CLS_MON_EVENT
CONSUMER_IP
For email alerts, data is stored in the Integration Server logs. The log data may contain account specific or user specific data, which may be considered as personal data or personally identifiable information. If for privacy concerns or to be in compliance with General Data Protection Regulation (GDPR), you want to delete the personal data of a user, you can manage the log files that contain the data from the file system. See the webMethods Integration Server Administrator’s Guide for information on how to manage these logs, their related files, and specific identifiers to look for in the logs.
To edit the Log Invocation action parameters
1. In the CloudStreams Governance view, click the policy name.
2. In the policy editor on the right side of the page, double-click Log Invocation in the Applied Actions list, and set the following action parameters.
Log Generation Frequency
Specifies how frequently to log the payload.
Always: Log all requests and/or responses.
On Success: Log only the successful responses and/or requests.
On Failure: Log only the failed requests and/or responses.
Log the Following Payloads
Specifies whether to log all request payloads, all response payloads, or both.
Request: Log all request payloads.
Response: Log all response payloads.
Send Data To
By default, this action logs the payloads to the CloudStreams Analytics database.
Note:
Ensure that you select the Database Publishing option in Integration Server Administrator (go to Solutions > CloudStreams > Administration > Database), as described in the section Setting the Database Options for Publishing Run-Time Metrics and Events in the document Administering webMethods CloudStreams.
Alert Email
Right-click the action name and click Add Alert Email to send the payloads in an email alert to the email address you specify in the Email ID field. You can select Add Alert Email multiple times to add multiple email addresses.
Note:
Ensure that you select the email options in Integration Server Administrator (go to Solutions > CloudStreams > Administration > Email), as described in the section Setting the Email Options for Logging Payloads and Sending Performance Monitoring Alerts in the document Administering webMethods CloudStreams.