OCI virtual machine pattern-based discovery

  • Release version: Australia
  • Updated July 12, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of OCI virtual machine pattern-based discovery

    The OCI virtual machine pattern-based discovery enables ServiceNow customers to automatically identify and collect detailed information about Oracle Cloud Infrastructure (OCI) virtual machines within their cloud environments. This discovery populates the Configuration Management Database (CMDB) with comprehensive data about OCI VM instances, supporting accurate asset management and operational visibility.

    Show full answer Show less

    Key Features

    • Discovery and Service Mapping Patterns: Identifies OCI virtual machines and related resources using the Oracle OCI - Virtual Machine (LP) pattern.
    • Prerequisites: Requires following OCI discovery prerequisites and may require updating to the latest Discovery and Service Mapping Patterns application from the ServiceNow Store.
    • GovCloud Support: Supports discovery of OCI GovCloud accounts by configuring the discovery schedule with appropriate datacenter URLs and OCI service accounts.
    • Data Collection: Gathers detailed VM instance information including name, unique OCI object ID, CPU count, memory size, private IP address, VM state, install status, and operational status.
    • Image Discovery: Discovers OS images using the Image or Cloud Image tables, with guidance to use the Cloud Image [cmdbcicloudosimage] table to avoid excessive records.
    • CI Relationships: Automatically creates relationships between VMs, OCI datacenters, availability zones, images, servers, and network interfaces to reflect the infrastructure topology and dependencies.
    • OCI Tag Discovery: Collects OCI tags and stores them as key-value pairs linked to VM instances for enhanced categorization and filtering.

    Key Outcomes

    • Populates the CMDB with accurate, comprehensive OCI VM instance data to support IT operations, asset management, and service mapping.
    • Enables visibility into VM states and relationships within the OCI environment, facilitating impact analysis and change management.
    • Supports discovery of cloud OS images while managing data volume effectively by recommending appropriate tables for image storage.
    • Incorporates OCI tags into the CMDB, helping to leverage cloud metadata for governance, reporting, and automation.
    • Provides a foundation for ongoing discovery of OCI resources that can be integrated with broader ServiceNow ITOM capabilities.

    Discovery and Service Mapping Patterns finds OCI virtual machines (VMs) on your cloud environment. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

    Pattern-based discovery and mapping requirements

    Verify the OCI discovery prerequisites
    For more information, see the prerequisites section in Oracle Cloud Infrastructure (OCI) discovery.
    Configure the Discovery schedule to support GovCloud
    Discovering OCI GovCloud accounts requires using a datacenter URL when setting up an OCI service account. For more information, see Create OCI service accounts.

    Data collected by Discovery during horizontal discovery

    Discovery populates the data in the CMDB when running the Oracle OCI - Virtual Machine (LP) pattern.

    Table 1. Virtual Machine Instance [cmdb_ci_vm_instance]
    Field Description
    Name [name] The display name of the VM instance.
    Object ID [object_id] A unique identifier, allocated by Oracle OCI for this resource.
    CPUs [cpus] The number of Oracle CPU (OCPUs) available to the instance.
    Memory (MB) [memory] The amount of memory available to the instance, in gigabytes.
    IP Address [ip_address] The private IP address of the primary network interface attached to the instance.
    State [state] The current state of the virtual machine instance.

    For example: on, off, starting, stopping, scheduled, terminated, or error.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    Operational status [operational_status] Operational status of the resource. Default value is Operational.
    Table 2. Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image]
    Field Description
    Object ID [object_id] A unique identifier, allocated by Oracle OCI for this image.
    Provider [provider] The cloud provider, which is OCI.

    This field is only populated in the Cloud Image [cmdb_ci_cloud_os_image] table.
    Note:
    When using the Image [cmdb_ci_os_template] table to store Cloud OS images, you may notice an unusually large number of records. To avoid this issue, you can store the discovered OS images in the Cloud Image [cmdb_ci_cloud_os_image] table. For more information, see Enable Cloud OS Image discovery.

    CI relationships

    The Oracle OCI - Virtual Machine (LP) pattern creates the following relationships and references to support OCI VM discovery. References link to records in other tables and don't appear in the CI Relationship [cmdb_rel_ci] table.

    Table 3. CI relationships
    CI Relationship CI
    Virtual Machine Instance [cmdb_ci_vm_instance] Hosted on::Hosts OCI Datacenter [cmdb_ci_oci_datacenter]
    Availability Zone [cmdb_ci_availability_zone] Contains::Contained by Virtual Machine Instance [cmdb_ci_vm_instance]
    Virtual Machine Instance [cmdb_ci_vm_instance] DR provided by::Provides DR for Availability Zone [cmdb_ci_availability_zone]
    Virtual Machine Instance [cmdb_ci_vm_instance] Provisioned From::Provisioned Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image]
    Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image] Hosted on::Hosts OCI Datacenter [cmdb_ci_oci_datacenter]
    Server [cmdb_ci_server] Virtualized by::Virtualizes Virtual Machine Instance [cmdb_ci_vm_instance]
    Virtual Machine Instance [cmdb_ci_vm_instance] Use End Point To::Use End Point From VNIC Endpoint [cmdb_ci_endpoint_vnic]
    VNIC Endpoint [cmdb_ci_endpoint_vnic] Implement End Point To::Implement End Point From Cloud Mgmt Network Interface [cmdb_ci_nic]
    Table 4. CI references
    CI Field Referenced CI
    Key Value [cmdb_key_value] Configuration item [configuration_item] Virtual Machine Instance [cmdb_ci_vm_instance]

    OCI Tag discovery

    The Oracle OCI - Virtual Machine (LP) pattern collects tags and populates them in the Key Value [cmdb_key_value] table.

    Table 5. Key Value [cmdb_key_value]
    Field Description
    Key [key] Tag name.
    Value [value] Tag value.
    Configuration item [configuration_item] References the Virtual Machine Instance [cmdb_ci_vm_instance] table.