Skip to content

log-points.adoc

Latest commit

 

History

History
181 lines (126 loc) · 5.17 KB

log-points.adoc

File metadata and controls

181 lines (126 loc) · 5.17 KB

Generating Real-Time Logs (US and EU)

On US and EU Clouds, the Log Points feature in Anypoint Monitoring allows you to generate logs for apps and APIs in real-time and without writing code. For apps, you can specify the level of logs you want to generate, and for APIs, you can specify properties for the logs. This allows you to extract logs on-demand from applications in real-time, without causing re-deployment or application downtime. Permissions control allows you to manage access. All logs seamlessly flow into log management.

Log Points for Apps

The Application Log Points feature enables you to log information from connectors in any Mule app in real-time. If you are using one of the supported connectors, you can select a log level (debug, info, warn, or error) and generate logs.

Before You Begin

These prerequisites are required:

  • A supported Mule version.

reuse::partial$billing/pricing.adoc

  • The Runtime Manager > Manage Settings permission

Supported Connectors

The following Anypoint Connectors are available for use with the Log Points feature.

Table 1. Supported Connectors
Supported Anypoint Connectors Supported for Mule 4.x

Amazon S3

x

Amazon SQS

x

Database

x

Email

x

File

x

FTP

x

IBM MQ

x

JMS

x

Microsoft Service Bus

x

MongoDB

x

MQ

x

Object Store

x

Salesforce

x

SFTP

x

Sockets

x

VM Transport

x

Enable Application Log Points

  1. In the sidebar, click Log Points.

  2. Select the following:

    • Environment: The environment in which the app is running.

    • Resource name: The name of the app.

  3. Click Select.

  4. Select the connectors for which you want to generate logs.

  5. Select a log level for each connector.

  6. Click Save & Apply.
    A message that your configuration has been applied appears at the top of the page with a View API Logs link. The logs might take a moment to appear.

  7. Click the View Logs link to view the logs for the selected log point.

Note
 If you select either the trace or debug log level, disable log point monitoring when you are finished, to avoid slowing your application’s performance.

Log Points for APIs

The Log Points feature for APIs enables you to interactively extract data from running managed APIs. You can specify properties of your managed API (for example, the host and method in the request header) for which to generate logs without having to write code or redeploy your application. This helps you troubleshoot without having to restart the application.

For example, you can specify a cookie header in an API to see if an injection attack is in progress. The log data for the specified cookie header is automatically displayed in real time on the Logs page.

Prerequisites

To use this feature, you must have the following:

  • A supported Mule version

reuse::partial$billing/pricing.adoc

  • The API Manager > Manage Policies permission

Supported APIs

The following types of API are available for use with the Log Points feature:

  • Basic endpoint APIs (CloudHub and hybrid)

    • CloudHub

    • Hybrid

  • Endpoint with Proxy APIs

    • CloudHub proxy

    • Hybrid proxy

Note
 All basic endpoint APIs are displayed in the selectors regardless of whether the registered API has a supported Mule runtime engine version. If you save a log point for a basic endpoint API with an unsupported version, the application policy fails.

Supported Versions of Mule Runtime Engine

Enable API Log Points

  1. In the sidebar, click Log Points.

  2. Select the following:

    • Environment: The environment the API is running in.

    • Resource name: The name of the API.

    • Version/Instance: The version and instance of the API.

  3. Click Select.

  4. Select the Request points to log and monitor.
    You can monitor the following request header log points:

    • User Agent

    • Path

    • Host

    • Method

    • Remote Access

    • Accept

    • Accept Encoding

    • Accept Language

    • Cookie

    • Referrer
      You can click the blue box to the left of Header, to select all log points.
      Select Body to monitor the Request Body.

  5. Select the Response points to log and monitor.
    You can monitor the following request header log points:

    • Status Code

    • Connection

    • Date

    • Set-Cookie

    • Pragma

      You can click the blue box to the left of Header to select all log points. Select Body to monitor the Response Body.

  6. Click Save & Apply.
    A message that your configuration has been applied appears at the top of the page with a View API Logs link. The logs might take a moment to appear.

  7. Click the View API Logs link to view the logs for the selected log point.

Note
 When you are finished monitoring API log points, disable log point monitoring to avoid slowing your application’s performance.
⚡