Software AG Products 10.11 | Using CentraSite | Runtime Governance | Run-Time Policy Management | Built-In Run-Time Actions Reference (CentraSite Business UI) | Built-in Actions for Run-Time Policies (CentraSite Business UI) | Log Invocation
 
Log Invocation
This action logs request or response payloads. You can specify the log destination and the logging frequency. This action also logs other information about the requests or responses, such as the API name, operation name, the Integration Server user, a timestamp, and the response time.
Input Parameters
Payloads
(String). Specify whether to log all request or response payloads.
Value
Description
Request
Logs all request payloads.
Response
Logs all response payloads.
Log Generation Frequency
(String). Specify how frequently to log the payload.
Value
Description
Always
Logs all requests and responses.
On Success
Logs only the successful responses and requests.
On Failure
Logs only the failed requests and responses.
Send Data To
(String). Specify where to log the payload.
Important:
Ensure that Mediator is configured to log the payloads to the destination(s) you specify here. For details, see Administering webMethods Mediator.
Value
Description
API Portal
Mediator can use API Portal destination to publish data about run-time events and key performance indicator (KPI) metrics.
Mark the checkbox API Portal and select the API Portal instance from the drop-down list. When you mark the checkbox, CentraSite displays the list of API Portal instances that are registered and are available to you. To specify multiple API Portal instances, use the plus button to add rows.
Note:
When you publish an API that is configured with an API Portal destination to Mediator, CentraSite automatically creates an entry of the configured API Portal destination in the Integration Server Administrator's Solutions > Mediator > Administration > API Portal page.
Mediator uses the API Portal destination to publish the following event types:
*Transaction Events
*Monitoring Events
*Lifecycle Events
*Policy Violation Events
*Error Events
*Performance Metrics
You can also use the Mediator capability to specify the intervals at which the events and KPI metrics must be published to the API Portal destination.
Prerequisite: You must configure CentraSite to communicate with API Portal using the Add Gateway action.
CentraSite
Logs the payloads in the API's Events profile in CentraSite.
Prerequisite: You must configure Mediator to communicate with CentraSite (in the Integration Server Administrator, go to Solutions > Mediator > Administration > CentraSite Communication). For the procedure, see Administering webMethods Mediator.
Elasticsearch
Mediator can use Elasticsearch destination to publish data about run-time events and key performance indicator (KPI) metrics.
Mediator uses the Elasticsearch destination to publish the following event types:
*Transaction Events
*Monitoring Events
*Lifecycle Events
*Policy Violation Events
*Error Events
*Performance Metrics
You can also use the Mediator capability to specify the intervals at which the events and KPI metrics must be published to the Elasticsearch destination.
Prerequisite: You must configure the Elasticsearch destination (in the Integration Server Administrator, go to Solutions > Mediator > Administration > Elasticsearch). For the procedure, see Administering webMethods Mediator.
Local Log
Logs the payloads in the server log of the Integration Server on which Mediator is running.
Also select a value in the Log Level field:
*Info: logs the error-level, warning-level, and informational-level alerts.
*Warn: logs the error-level and warning-level alerts.
*Error: logs only error-level alerts.
Important:
The Integration Server Administrator's logging level for Mediator should match the logging level specified for this action (go to Settings > Logging > Server Logger).
SNMP
Logs the payloads in CentraSite's SNMP server or a third-party SNMP server.
Prerequisite: You must configure the SNMP server destination (in the Integration Server Administrator, go to Solutions > Mediator > Administration > SNMP).
Email
Sends the payloads to an SMTP email server, which sends them to the email address(es) you specify here. Mediator sends the payloads as email attachments that are compressed using gzip data compression. To specify multiple addresses, use the plus button to add rows.
Prerequisite: You must configure the SMTP server destination (in the Integration Server Administrator, go to Solutions > Mediator > Administration > Email). For the procedure, see Administering webMethods Mediator.
Audit Log
Logs the payload to the Integration Server audit logger. For more information about logging, see the webMethods Audit Logging Guide.
Note:
If you expect a high volume of events in your system, it is recommended that you select the Audit Log destination for this action.
EDA/Database
Logs the payloads in an EDA endpoint/Database destination that you configured in Integration Server Administrator:
*An EDA endpoint (that is, a default endpoint configured in the universal messaging configuration).
*A Database (that is, a JDBC connection pool is defined in Integration Server and associated with the Mediator functional alias).
Prerequisite: You must configure the EDA/Database destination in Integration Server on the Solutions > Mediator > Administration > EDA/Database Configuration page. For details, see Administering webMethods Mediator.