Articles in this section

Configure APIM analytics, logging, and notifications

After you’ve created and published your API, you can configure your analytics and notifications. Learn more about the different aspects of the APIM console.

Dashboard

You can configure Platform, API, or Application dashboards. You can review dashboards in the console Dashboard in the left-most navigation menu and API-specific dashboards under your API → Analytics.

Generate new dashboard

  1. Navigate to your console Settings in the left-hand menu.

  2. Under the Portal heading, click Analytics.

    Analytics.png
  3. Click Add a new dashboard and enter your dashboard details, including an optional query filter.

  4. Click the + at the bottom right-hand side of the screen to add a new widget.

  5. You can configure many widgets, including tables, line or pie charts, graphs, maps, or statistics.

  6. Select your field or use custom fields for your widgets.

  7. Click Save.

  8. Click Enable preview to review your dashboard, or simply check Enable dashboard to make your dashboard live.

Health check analytics

A health check is a mechanism to monitor the availability and health of your endpoints and/or API Gateways. You can configure health checks for both endpoints and API Gateways. Like load-balancing and failover, health checks are backend services. To ensure that you are prepared to use health checks, make sure that you are familiar with the following concepts:

  • Trigger: define what triggers the health checks.

    • HTTP methods

    • Paths

    • Headers

  • Schedule: the schedule at which health checks can be triggered. These can be configured in seconds, minutes, hours, days, weeks, months, and years.

  • From root path: enable this to apply the specified path at the root URL level. For example, if your endpoint URL is www.test.com/api, this option removes /api before appending the path.

  • Assertions: where you specify any specific conditions to test for in the API response that will trigger a health check. Assertions are written in Expression Language. An assertion can be a simple 200 response (#response.status == 200), but you can also test for specific content.

After configuring health checks, you can view health check information and results in the Health-check dashboard for that specific API. Here, you have multiple charts to track:

  • Global availability: average availability and average response times for all health-checked endpoints.

  • Per-endpoint availability: average availability and average response times for specific endpoints.

  • Per-gateway availability: average availability and response times per API Gateway where health-check is enabled.

  • Latest check: a running list of the most recent health checks. You can choose to show only status transitions.

Enable health check analytics

  1. Navigate to your API → Health check.

    Health_check_menu.png
  2. Toggle Enable health-check to ON.

    Health_check_analytics.png
  3. Configure analytics as desired.

To view your health check analytics, navigate to Dashboard → APIs health-check → your API.

Logging

You can enable logs at the API level. Use logging with caution and only for development purposes. It requires more space for analytics storage and can impact API performance.

API_logs_.png

Enable logging

  1. Navigate to your API → Logs.

    API_Logs_menu.png
  2. Click Configure the logging.

  3. Choose your logging, content, and scope modes.

    Configure_API_logging.png

View log records

Comprehensive connection logs allow you to analyze your API’s usage. To view the runtime logs associated with calls to your API:

  1. Open your API Management Console.

  2. Navigate to APIs → your API.

  3. Click on Logs in the inner left sidebar.

Notifications

Enable notifications at the API or system level.

Enable API notifications

  1. Navigate to your API → Notifications settings.

    API_notifications.png
  2. Click + Add notification at the upper right-hand corner of your screen.

    API_notifications_list.png
  3. Configure your notification settings by API key, Subscription, Support, Lifecycle, Rating, or Review.

Delete API notifications

  1. Navigate to your API → Notifications settings.

  2. Click the Trashcan to the right of the specific notification you want to delete.

  3. Confirm that you want to delete the notification.

Enable system notifications

  1. Click Settings in the left-most navigation menu.

  2. Click Notifications settings at the bottom of the second menu.

  3. Click + Add notification at the upper right-hand corner of your screen.

  4. Configure your notification settings by User, Support, or Group.

Settings_notifications.png
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.