Oracle Cloud Infrastructure Documentation

Viewing the Instance Activity Report

View the instance activity report, which displays the status and number of instances that are checking in with OS Management Hub.

    1. Open the navigation menu and click Observability & Management. Under OS Management Hub, click Reports.
    2. Under List scope, choose a compartment that contains the instances you're interested in.
    3. Click the Instance activity report.
    4. (Optional) Under Filters, select one or more of the following options to refine the report:

      The following options are available for status:

      • Active: An instance that's actively checking in with the service. An active instance checks in with the service at an interval of every 2 minutes.
      • Offline: An instance that hasn't checked in with the service for 24 hours (or longer).
      • Inactive: An instance that hasn't checked in with the service in 30 minutes (or longer).
      • Registering: An instance that's in the process of registering with the service.
      • Registration failed: An instance that failed to register with the service.
      • Unregistering: An instance that's unregistering from the service. Once unregistered, OS Management Hub will no longer manage the instance.

      The following options are available for the type instance:

      • Operating systems: Lists only the instances with the specified OS.
      • Location: Lists only the instances with the specified location.
    5. Click Download report to download the full report in CSV, JSON, or XML format.

  • Use the oci os-management-hub managed-instance summarize-analytics command and required parameters to return metrics for a compartment of managed instances.

    oci os-management-hub managed-instance summarize-analytics --compartment-id ocid --metric-names metric-type [OPTIONS]

    Possible metric-names include:

    • NORMAL_INSTANCE_COUNT
    • REGISTRATION_FAILED_INSTANCE_COUNT
    • UNREACHABLE_INSTANCE_COUNT
    • WARNING_INSTANCE_COUNT

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the SummarizeManagedInstanceAnalytics operation to return metrics for a collection of managed instances.