Tracking Analytics in Oracle API Platform Cloud Service


Options



Before You Begin

Purpose

Learn how to view your application programming interface (API) analytics to understand how and when they're used.

Time to Complete

40 minutes

Background

To properly maintain your APIs, you must understand the demand, usage, failure, trends, and events in your API ecosystem. You do that by checking your API analytics in the Management Portal, which is part of Oracle API Platform Cloud Service.

  • On the API Analytics page, you can review the API analytics for requests from specified applications or requests to specified gateways.
  • On the Gateway Analytics page, you can browse the analytics for the APIs deployed to your gateway, selecting requests to specified APIs or requests from specified applications.

Note: You can also review the Application Analytics page in the Developer Portal, but this feature is outside the scope of this tutorial.

What Do You Need?

Navigating to the API Analytics Page

  1. In your browser, enter http://hostname.domain:8080/apiplatform.

  2. On the Oracle API Platform Cloud Management Portal login page, enter your user name and password, and click Sign In.

    Oracle API Cloud Management Portal login page
    Description of this image
  3. On the APIs List page, click Energy.

    The Energy API as listed on the APIs List page
    Description of this image
  4. On the API Implementation page, click the Analytics tab The Analytics tab.

    The Analytics page opens.

    The API Analytics page
    Description of this image

Navigating to the Gateway Analytics Page

  1. In your browser, enter http://hostname.domain:8080/apiplatform.

  2. On the Oracle API Platform Cloud Management Portal login page, enter your user name and password, and click Sign In.

  3. On the Management Portal page, click Gateways.

    The Gateway link on the Management Portal page
    Description of this image
  4. On the Gateways page, click a gateway.

    The Gateways page
    Description of this image
  5. On the Gateway Details page, click the Analytics tab The Analytics tab.

    The gateway Analytics page opens.

    The Gateway Analytics page
    Description of this image

Exploring General Analytics

The general analytics page shows charts for all requests. You can filter data by gateway, registered application, period of time, and request status (rejected, failed, or successful).

Reviewing the Request Volume Chart

This chart displays the number of requests of a deployed API in a gateway. You can filter the data by all requests or by successful, rejected, or failed requests.

  1. Click General to view all requests in the charts.

    The General analytics tile
    Description of this image
  2. Click the Click to customize time interval link.

    The customized time range filter on the Analytics page
    Description of this image

    The Start and End fields are displayed.

  3. Click Start and select the start date and time, click End and select the end date and time.

    The Start and End date and time fields in the customized time range filter
    Description of this image
  4. To filter your data, perform one of the following actions:

  5. Scroll down to the Request Volume chart, click All, and review the requests for your API.

    The Request Volume chart, showing all the requests
    Description of this image
  6. Click Successful and review the successful requests for your API.

    The Request Volume chart, showing successful requests
    Description of this image
  7. Click Rejected and review the rejected requests.

    The Request Volume chart, showing rejected requests
    Description of this image
  8. Click Failed and review the failed requests.

    The Request Volume chart, showing failed requests
    Description of this image

Reviewing the Response Time Chart

This chart displays the time ranges of requests and responses for your API.

  1. Scroll down to the Response Time chart and click Round Trip.

    The Response Time chart showing the selected Round Trip filter
    Description of this image
  2. Place your cursor over the response range bar and review the response times displayed in the round-trip details box.

    The details box of a response time bar
    Description of this image
  3. Click API Layer. Review the chart that displays the bars corresponding to the time ranges spent per request in the API layer.

    The Response Time chart, filtered by API Layer responses
    Description of this image
  4. Click Service Layer. Review the chart that displays the bars corresponding to the time ranges spent per request in the service layer.

    The Response Time chart, filtered by back-end responses
    Description of this image

Reviewing the Payload Size Chart

This chart displays the size of requests and responses made to your deployed API. You can filter the data by request or by response payloads.

Scroll down to the Payload Size chart and click Request.

The Payload Size chart, filtered by request payload
Description of this image

Note: In this tutorial, the requests in the chart don't have payloads. Keep in mind that requests with payloads do exist.

Reviewing the Requests by API Chart

This chart, which is exclusive to gateway analytics, displays the distribution of your API requests.

Scroll down to the Requests by API chart and review the information in the API, Requests, Rejections, and Errors columns.

The Requests by API chart
Description of this image

Reviewing the Requests by Resource Chart

This chart displays the distribution of your requests by request path.

Scroll down to the Requests by Resource chart and review the information in the Request Path, Requests, Rejections, and Errors columns.

The Requests by Resource chart
Description of this image

Exploring Application Analytics

This chart shows the requests for each registered application.

  1. Click Applications to review the requests in the charts.

    The Applications analytics tile
    Description of this image
  2. Scroll down to the Active Applications chart and review the information in the Application, Requests, Rejections, and Errors columns.

    The Active Applications chart
    Description of this image

Exploring the Errors and Rejections Analytics

These charts show the failed and rejected requests.

Applying Errors and Rejections Chart Filters

Use these filters for all charts:

  • All: View all requests.
  • Request Policies: View the failed or rejected requests from the request flow.
  • Response Policies: View the failed or rejected requests from the response flow.
  • Service: View the failed or rejected requests at the back end.

Use one of the following filters for the Rejection Rate and Error Rate charts:

  • No policy filter: View all the requests.
  • Show Policy Instances: View the errors or rejections from each instance of a policy. For example, if errors or rejections are generated from multiple header validation policies, then all header validation policy errors or rejections are displayed as a single data point.
  • Show Policy Types: View the errors or rejections for each policy type. For example, if errors or rejections are generated from multiple header validation policies, all header validation policy errors are displayed as separate data points.
  • Built-in Policy Types: View the failed or rejected requests by OAuth2Validator, SLAEnforcement, or Sender policies.

You can use the Show Policy Instances and Show Policy Types filters only for the Rejection Distribution and the Error Distribution charts.

Reviewing the Rejection Rate Chart

This chart displays the frequency of the rejected requests through time.

  1. Click Errors and Rejections.

    The Errors and Rejections tile
    Description of this image
  2. Scroll down to the Rejection Rate chart, click All, and select No policy filter. Review the chart contents.

    The Rejection Rate chart
    Description of this image
  3. In the policy filter list, under Policy Instances, select API Rate Limiting.

    The Policy filter list
    Description of this image

    The chart displays only the requests that were rejected by the API Rate Limiting policy.

    The Rejection Rate chart, filtered by the API Rate Limiting policy
    Description of this image
  4. In the policy filter list, under Policy Types, select Header Validation.

    The policy filter list, showing the selected Header Validation filter
    Description of this image

    The chart displays only the requests that were rejected by the Header Validation policy.

    The Rejection Rate chart, filtered by the Header Validation policy
    Description of this image

Reviewing the Rejection Distribution Chart

This chart displays the rejections for your API requests, classified by policy types or policy instances.

  1. Scroll down to the Rejection Distribution chart, click All, and select Show Policy Instances from the policy filter list.

    The Rejection Distribution chart, displaying the responses, requests, and service rejections
    Description of this image
  2. Select Show Policy Types.

    The Policy classification filter
    Description of this image
  3. Review how the same rejections are plotted in the four bars, one for each policy type.

    The Rejection Distribution chart, displaying rejections by policy type
    Description of this image

Reviewing the Error Rate Chart

This chart displays the frequency of the failed requests.

Scroll down to the Error Rate chart, click All, and select No Policy from policy filter list.

The Error Rate chart
Description of this image

Reviewing the Error Distribution Chart

This chart displays the number of errors for your API requests, classified by policy types or policy instances.

Scroll down to the Error Distribution chart, click All, and select Show Policy Instances from the policy filter list.

The Error Distribution chart
Description of this image

Want to Learn More?