Oracle Cloud Infrastructure Documentation

Viewing Usage Metrics for Compute

View the current usage and overall available capacity for Compute by the hardware type in Control Center.

The following details are available for each combination of a supported Compute shape and hardware generation: The number of available bare metals, virtual machines, total available bare metals and virtual machines, total used, and total capacity, plus memory (utilization, available BM and VM, and total available, used, and capacity). In addition, the following information is available.

  • Usage details by consumption type, server type, fault domain, and availability domain.
  • Categorization of consumption, including hardware generation in cores, usage percentage, availability for bare metal (BM) and virtual machines (VMs), and totals for used, available, and capacity.
  • Usage analysis across Compute shapes.
  • Usage analysis for a specific shape or hardware.
  • In-depth usage detail for a shape.
    1. Open the navigation menu  and select Governance & Administration. Under Control Center, select Compute.
      The Compute page for Control Center opens. Your current region is displayed at the upper right of the Console. If your tenancy is subscribed to several regions, you can switch regions by selecting a different region from the Regions menu. To limit shapes in the list, see Filtering List Results.
    2. To get further usage details of each processor, select View usage breakdown.

      The Usage breakdown panel opens, listing usage by consumption type, server type, fault domain, and availability domain. Usage details include memory information. To limit shapes in the list, see Filtering List Results.

      To return to the previous page, select Cancel.

    Following are tasks you can do with Compute metrics in Control Center.

    Opening the Shape Details Page

    Find in-depth usage details for a supported shape, such as Intel Standard, AMD Standard, Intel Dense, and AMD Dense .

    Note

    Only the processors available in your region are displayed.
    On the Compute page in Control Center, under Shape type, select the shape. If you need help finding this page, see Using the Console.
    The shape's details page opens. The page includes filters, a current snapshot graph, usage by tenancy, and historical charts.

    Filtering Shape Information

    Filter information for the current shape to refine its data and charts.
    1. On the shape details page, under Filters and Actions, select Edit. If you need help finding this page, see Opening the Shape Details Page.
    2. In the Edit usage filter panel, enter the following information.
      • Compartment: Select or remove options to filter by compartment.
      • Filter by consumption type: Select or remove options to filter existing data. All filter options are enabled by default.
      • Hardware generation: Select or remove options based on hardware shapes. For example, OCI X7 and X9 instance shapes for Intel Standard and E3 or E4 for AMD Standard.
      • Breakdown by: Select or remove options to filter based on fault domains within an availability domain.
      • Fault domain (applies when you select fault domain for Breakdown by): Select or remove fault domains.
    3. Select Update.

    Viewing the Current Snapshot

    Find the current usage, available capacity in cores, and memory usage and capacity from the Current Snapshot graph. Data depends on filter options.

    The usage is calculated based on an hourly usage average for a specific day. Usage includes the following details:

    • Overhead: Represents the cores required to manage each Compute server and cores used by each hypervisor such as, to boot up VMs when hypervisors are deployed, which requires capacity. Also, overhead includes servers that need recycling or repair.
    • OCI usage: Represents the control plane and OCI usage to support extra resources. These resources can be the usage based on the resources that OCC instantiates when you instantiate a PaaS service, and make the PaaS service available.
    • Customer usage: Represents the IaaS usage. For example, to boot up VMs in an IaaS environment.
    • Customer reserve usage: Represents the IaaS capacity reserved by any customer tenancy. For example, to boot up VMs in an IaaS environment reserved by any customer tenancy.
    • Available: Represents the total capacity available to you in a specific environment. This capacity is across all three fault domains within an availability domain and the capacity required for bare metals or VMs across all nodes. For information about fault domains, see Fault Domains.
    On the shape details page, find the Current Snapshot graph. If you need help finding this page, see Opening the Shape Details Page.

    Viewing Usage by Tenancy

    Find Compute usage by the customer tenancy.
    On the shape details page, expand Compute usage by tenancy. If you need help finding this page, see Opening the Shape Details Page. Data depends on filter options.

    Viewing Historical Charts and Organic Forecasting

    Historical data represents the consumption of all overhead usage, OCI usage, customer usage, and available capacity in the last 30 days by default. Enable organic forecasting and find the usage projection based on heuristic.
    1. On the shape details page, scroll down to the Historical charts section. If you need help finding this page, see Opening the Shape Details Page.
    2. To change the time period, select Select time frame (under Historical charts).
    3. To enable organic forecasting, do the following.
      1. Under Historical charts, select Select time frame.
      2. In the Select time frame panel, turn on Forecast toggle.
      3. Select the start and end dates that you want.
      4. Select Update.

      Information includes overhead usage, OCI usage, customer usage, and available capacity. This projection can be used during the planning cycle to find the rate of consumption and decide on usage expansion. See Managing Organic Forecasting.

      When you enable organic forecast, the organic forecast chart is displayed within to the Historical chart.

    Exporting the Shape Details

    You can export the shape details from the Console to Excel, CSV, or PPTX.

    Tip

    Consider filtering shape details to refine the data and charts for the selected shape before exporting. For instructions, see Filtering Shape Information.
    1. On the upper right of the shape details page, select Export.
    2. In the Export dialog box, select the format that you want.
    3. Select Confirm.

    Viewing In-depth Usage

    You can view in-depth usage details for hypervisors (VMs) and bare metal instances (BMs) in the selected shape

    Viewing In-depth Usage for Hypervisors (VMs)

    Find in-depth usage details for hypervisors (VMs) in the selected shape. You can view by availability domain or fault domain. You can analyze hypervisor placement and simulate VM placement.
    1. On the shape details page, select Open (next to Open Hypervisors/BM View). If you need help finding this page, see Opening the Shape Details Page.
      The Compute types page for the selected shape opens to the Hypervisor details tab. By default, the Availability domain view selected. Capacity cores and memory are depicted in a chart and a list view is provided. To limit items in the list, see Filtering List Results.
    2. To switch to the Fault domain view or to change filters, do the following.
      1. Select Refine results.
      2. In the Refine results panel, select the view that you want.
      3. Select values for other filters.
      4. Select Apply.
    3. To analyze hypervisor placement, do the following.
      1. Select Analyze.

        The Hypervisor placement analysis page for the shape hypervisors opens, with VM placement modeling tab opened by default.

      2. Select Heatmap modeling.

        By default, the Availability domain view selected.

      3. To switch to the Fault domain view or to change filters, do the following.

        1. Select Refine results.
        2. In the Refine results panel, select the view that you want.
        3. Select values for other filters.
        4. Select Apply.
      4. To edit heatmap values for OCPUs and memory, do the following.
        1. Select Edit.
        2. In the Edit OCPU and memory options panel, enter the values that you want.
        3. Select Save changes.
      5. To export heatmap values to a Microsoft Excel file, select Export and follow the prompts.
    4. To simulate VM placement, do the following.
      1. Select VM placement modeling.

        By default, the Availability domain view selected.

      2. To switch to the Fault domain view or to change filters, do the following.

        1. Select Refine results.
        2. In the Refine results panel, select the view that you want.
        3. Select values for other filters.
        4. Select Apply.
      3. Select Create simulation.
      4. In the Create simulation form, provide the following information.
        • Simulation name
        • Cores per VM
        • Memory (GB) per VM
      5. Select Create simulation.

        The list updates to show the new simulation, indicating VM count, stranded cores, and stranded memory for the provided information. Stranded items (cores and memory) are unusable because of hypervisor fragmentation.

    Viewing In-depth Usage for Bare Metal Instances (BMs)

    Find in-depth usage details for bare metal instances (BMs) in the selected shape. You can view by availability domain or fault domain.
    1. On the shape details page, select Open (next to Open Hypervisors/BM View). If you need help finding this page, see Opening the Shape Details Page.
      The Compute types page for the selected shape opens to the Baremetal details tab. By default, the Availability domain view is selected. Consumed and available cores are depicted in a chart and a list view is provided. To limit items in the list, see Filtering List Results.
    2. To switch to the Fault domain view or to change filters, do the following.
      1. Select Refine results.
      2. In the Refine results panel, select the view that you want.
      3. Select values for other filters.
      4. Select Apply.

    Filtering List Results

    Use filters to limit the items in a list, such as the list of shapes on the Compute page or Usage breakdown page.

    From the Search and Filter box above the list table, select one or more filters and specify the values that you want to use to narrow the list. In general, the filters correspond to the columns shown in the list table, although some filters represent attributes that aren't shown in the table. The Compartment filter is always displayed next to Applied filters.

    Change the order of the items in the list table by using the sort icons next to the column names.

    For information about searching for resources and managing the columns in the list table, see Listing Resources.

  • Use the list command and required parameters to list the available source services (namespaces) emitting metrics:

    oci occ namespace list [OPTIONS]

    Use the read command and required parameters to view the usage metric:

    oci occ metric-data read [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the RequestSummarizedMetricData operation to view the usage details by consumption type and server type for a Compute shape.

    To view in-depth usage details for hypervisors (VMs), specify the namespace COMPUTE HYPERVISOR and metric (metricName) COMPUTE_HV_DETAILS.

    To view in-depth usage details for bare metal instances (BMs), specify the namespace COMPUTE BAREMETAL and metric (metricName) COMPUTE_BM_DETAILS.