OCI virtual machine pattern-based discovery

  • Release version: Zurich
  • 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 discover Oracle Cloud Infrastructure (OCI) virtual machines within their cloud environment using Discovery and Service Mapping Patterns. This discovery populates detailed configuration data into the CMDB, supporting effective cloud resource management and service mapping for OCI VMs.

    Show full answer Show less

    Key Features

    • Pattern-based Discovery: Uses the Oracle OCI - Virtual Machine (LP) pattern to identify and collect VM instance details.
    • Prerequisites and Configuration: Requires adherence to OCI discovery prerequisites and configuration of discovery schedules, especially when discovering Oracle GovCloud (US) accounts using specific datacenter URLs and OCI service accounts.
    • Comprehensive Data Collection: Discovers and records VM instance attributes such as name, unique Oracle-assigned object ID, CPU count (OCPUs), memory size, private IP address, VM state (e.g., on, off, terminated), install status, and operational status.
    • OS Image Management: Discovers OS images linked to VMs, storing them in either the Image [cmdbciostemplate] or Cloud Image [cmdbcicloudosimage] tables, with a recommendation to use the Cloud Image table to reduce record volume.
    • CI Relationships and References: Automatically creates relationships between discovered VMs and other CIs such as OCI Datacenters, Availability Zones, provisioned images, VNIC endpoints, and servers to accurately represent the cloud infrastructure.
    • OCI Tag Discovery: Collects and stores OCI tags associated with VMs in the Key Value [cmdbkeyvalue] table, linking tags directly to VM instances for enhanced classification and management.

    Practical Benefits for ServiceNow Customers

    • Enables accurate and automated population of OCI VM data into the CMDB, supporting a reliable single source of truth for cloud assets.
    • Facilitates detailed visibility into VM configurations, operational states, and relationships within the OCI environment, aiding in impact analysis and service mapping.
    • Supports cloud governance and compliance by capturing OCI tags and metadata linked to virtual machines.
    • Improves discovery efficiency and reduces data clutter by recommending best practices for OS image storage.

    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 Oracle GovCloud (US) accounts requires using a datacenter URL when setting up an Oracle 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.