Oracle by Example brandingTracking Analytics in Oracle API Platform Cloud Service

section 0Before You Begin

This 15-minute tutorial shows you how to view analytics data for your API and gateway to understand how and when they're used.

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.

  • For APIs, you can review the analytics for requests from specified applications or requests to specified gateways.
  • For gateways, you can browse the analytics for the APIs deployed to your gateway, selecting requests to specified APIs or requests from specified applications.

What Do You Need?

  • Access to an Oracle API Platform Cloud Service instance
  • An API Manager user and a Gateway Manager user
  • The Warranty Claim API
  • A REST API client to send several calls to the deployed Warranty Claim API so that you have some data

section 1View Analytics for APIs

First, sign in to the Management Portal and access the Analytics page for your API.

  1. Sign in to Oracle API Platform Cloud Service Management Portal as an API Manager using the following URL format.

    https://<instance-identityDomain>.apiplatform.ocp.oraclecloud.com/management

    For example, https://myinstance-demo.apiplatform.ocp.oraclecloud.com/management

    where instance-identityDomain refers to the identity domain of your Oracle API Platform Cloud Service Management Portal instance.

  2. On the APIs page, click the Warranty Claim API.
  3. Click Analytics Analytics icon. The Analytics page is displayed.
    API Analytics page
    Description of the illustration api-analytics1.png
  4. Note that the number and spacing of the bars in the chart will appear differently in your instance.


section 2Filter Analytics Results for a Specified Time Period

You want to view the volume of requests to the API in a certain time period.

  1. In the Filters section on the Analytics page, click the Begin Date/Time field.
  2. Enter a beginning date and click Done.
  3. Click the End Date/Time field.
  4. Enter an ending date and click Done.
    Filtering for a time period
    Description of the illustration api-analytics2.png

section 3View Analytics for Gateways

You now want to view the analytics for the gateway on which the API is deployed. You need to log in as a user with Gateway Manager rights.

  1. Sign out of the API Manager Portal and sign in as a Gateway Manager user.
  2. From the Oracle API Platform Cloud Service navigation menu, select Gateways.
  3. Navigating to the Gateways tab
    Description of the illustration api-analytics3.png
  4. On the Gateways page, click the gateway to which your API is deployed.
  5. Click Analytics Analytics icon.
    Gateway Analytics tab
    Description of the illustration api-analytics4.png

section 4Filter Analytics Results for a Specific API

You want to see the request volume for the Warranty Claim API only.

  1. On the Analytics page, in the Objects section, click the APIs field.
  2. Click the Warranty Claim API.
    Filtering for an API
    Description of the illustration api-analytics5.png

more informationWant to Learn More?