Oracle® Fusion Middleware
Part 8. API Gateway Analytics

You can configure real-time monitoring metrics at the API Gateway instance level. For example, these enable you to specify monitoring of the message content. API Service Manager and API Gateway Analytics use this data to display graphical reports in their web-based interfaces. In addition, for API Gateway Analytics, you can also specify the database to which the instance writes metrics data.

To configure real-time monitoring metrics, select the Settings node in the Policy Studio tree, and click the Metrics tab at the bottom. The following fields are available on the Metrics tab.

Enable real time monitoring:

This enables real-time monitoring globally for the API Gateway. This setting must be selected to monitor traffic processed by the API Gateway, and is enabled by default. To disable real-time monitoring, disable this setting.

Store real time monitoring data for charts/reports:

If you wish real-time monitoring data to be written to a database, select this setting. This enables the following fields.

Use the following database:

Click the button on the right to select a database in which you wish to store the metrics data. If you have already configured the database connection, you can select it in the tree. To add a database connection, right-click the Database Connections tree node, and select Add DB Connection. Alternatively, you can add database connections under the External Connections node in the Policy Studio tree view. For more information on configuring database connections, see the Database Connection topic.

Store specified message attribute values:

Select this setting to store the values of specified messages attributes in the database. Click the Add button, enter the appropriate message attribute name in the Value field, and click OK. Repeat to add multiple message attributes.

When specified message attributes are present in a message running through the API Gateway, their values are stored the database. For example, you could specify my.example.attribute to be stored in the database. For any message running through the API Gateway that has the my.example.attribute attribute set, the message ID, attribute name, and the value (for example, My example message subject) are stored in database. You could then use this information to view reports for messages with specific message subjects or IDs.

The specified attributes add metadata to the audit trail for a transaction, which can be queried in the API Gateway Analytics console. A common use case is when the group or organization of an authenticated user is stored and queried for a transaction. In this case, the message attribute on the white board that contains the user's organization should be stored with the audit trail on completion of the transaction. In this way, the additional attributes to be stored with a transaction are then available to searched on in the audit trail in API Gateway Analytics

CPU, Memory, Disk polling interval:

Specifies the interval in seconds when polling CPU use, free memory, and disk settings used in system monitoring. Defaults to 3 seconds.