Viewing Usage Metrics for Compute

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

  • The Overview tab for Compute provides usage details by consumption type, server type, fault domain, and Availability domain for a Compute shape. It shows the categorization of consumption for each shape, including, hardware generation in cores, usage percentage, availability for bare metal (BM) and virtual machines (VMs), and totals for used, available, and capacity. This overview allows you to analyze usage across different Compute shapes or focus on a specific shape or hardware.

    The other tabs for Compute provide an in-depth usage detail for each of the Compute shapes that OCC supports. For more information about Compute shapes, see Compute Shapes.

    1. Open the navigation menu  and select Governance & Administration. Select Control Center.
      Note

      By default, the Region Details for Compute page appears. If the Region Details page doesn't display any information, select a different compartment from the Compartment list (on the left side of the page).
      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.
    2. In the Overview tab on the Region Details for Compute page, find details for each combination of Compute shape and hardware generation.

      Details include 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).

    3. To get further usage details of each processor, select View usage breakdown.
      The Usage breakdown panel opens, listing usage by consumption type, server type, the three fault domains, and availability domains. Usage details include memory information.
    4. To find in-depth usage details for a shape supported by OCC, select the tab for that shape.
      Note

      Only the processors available in your region are displayed.

      Example shapes: Intel Standard, AMD Standard, Intel Dense, and AMD Dense .

      To filter the shape information (refine data and charts for the selected shape):

      • Select or remove an option from the Filter by consumption type filter bar menu to filter existing data. All filter options are enabled by default.
      • Select or remove an option from the Hardware generation filter bar menu to filter based on hardware shapes. For example, OCI X7 and X9 instance shapes for Intel Standard and E3 or E4 for AMD Standard.
      • Select or remove an option from the Breakdowns filter bar menu to filter based on fault domains within an availability domain.
      • If you select fault domain in the previous step, select or remove a fault domain option from the Fault domains filter bar menu to filter capacities based on three fault domains.
    5. Find the current usage, available capacity in cores, and memory usage and capacity from Current snapshot - <latest available date>: graph. The usage is calculated based on an hourly usage average for a specific day. It includes the following details:
      Note

      The data in this section depends on the shape filter options.
      • Overhead usage (blue): 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 (red): 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 (green): Represents the IaaS usage. For example, to boot up VMs in an IaaS environment.
      • Available capacity (gray): 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.
    6. Expand Usage breakdown to view the usage categorization by tenancy and Compute shape.
      Note

      The data in this section depends on the shape filter options.

      The table shows the Compute usage by the customer tenancy.

    7. To enable organic forecasting and find the usage projection based on heuristic, expand Organic forecast and turn on Enable.

      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 next to the Historical chart. These two charts are separated by a line for comparison with the projected data.

      When selecting the start or end date, you can also select a range of periods such as one month (1M), two months (2M), and so on.

    8. View the historical data that represents the consumption of all overhead usage, OCI usage, customer usage, available capacity, and memory used in the last 30 days.
      You can select a range of periods or a custom period and find the equivalent data displayed. The default time is the past 30 days. Hover over the historical chart to find the usage details in the respective units of the resources compared to the total capacity on a specific date.
    9. To export the historical chart data and usage consumption data from the Console into an Excel, CSV, or PPTX format, do the following.
      1. On the upper right of the page, select Export and then select the format that you want.
      2. In the export dialog, select Confirm.
    10. To find in-depth usage details for hypervisors (VMs) in the selected shape, select Hypervisors (on the upper right of the shape tab).

      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 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.

      To limit the items under Total VM capacity - List view, use filters.

      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.

      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.

      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 due to hypervisor fragmentation.

    11. To find in-depth usage details for bare metal instances (BMs) in the selected shape, select Bare Metals (on the upper right of the shape tab).

      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 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.

      To limit the items under Total BM capacity - List view, use filters.

      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.