GCP virtual server pattern-based discovery

  • Release version: Zurich
  • Updated January 22, 2025
  • 6 minutes to read

    • Discovery and Service Mapping Patterns finds GCP Virtual Machine (VM) instances and related resources 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 GCP discovery prerequisites section in Google Cloud Platform (GCP) Cloud discovery using Patterns.

    Data collected by Discovery during horizontal discovery

    Discovery populates the data in the CMDB when running the Google Cloud Platform (GCP) - Virtual Server pattern.

    Table 1. Cloud Service Account [cmdb_ci_cloud_service_account]
    Field Description
    Account Id [account_id] Name of the project used for the discovery.
    Object ID [object_id] Name of the project used for the discovery.
    Datacenter Type [datacenter_type] Datacenter type: Google Datacenter [cmdb_ci_google_datacenter].
    Table 2. Availability Zone [cmdb_ci_availability_zone]
    Field Description
    Name [name] Name of the availability zone.
    Description [short_description] Description of the availability zone.
    State [state] State of the Availability Zone. Possible values are Available or Terminated.
    Table 3. Google Datacenter [cmdb_ci_google_datacenter]
    Field Description
    Name [name] Datacenter or region name.
    Region [region] Datacenter or region name.
    Object ID [object_id] Unique identifier allocated by GCP for this resource.
    Description [short_description] Datacenter or region description.
    Table 4. Virtual Machine Instance [cmdb_ci_vm_instance]
    Field Description
    Object ID [object_id] Unique identifier for the VM instance.
    VM Instance ID [vm_inst_id] Unique identifier for the VM instance.
    Name [name] Name of the VM instance.
    State [state] Operational state of the virtual machine.

    For example: On, Off, or Terminated.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    CPUs [cpus] Number of virtual CPUs (vCPUs) allocated to the instance.
    Memory (MB) [memory] Amount of memory in megabytes (MB) allocated to the instance.
    Termination Protection [termination_protection] Indicates whether deletion protection is enabled and the instance can't be deleted.

    Possible values are true or false.
    Disks [disks] Number of disks attached to the VM instance.
    Disks size (GB) [disks_size] Total size of all disks attached to the instance in gigabytes (GB).
    Network adapters [nics] Number of network interfaces attached to the VM instance.
    IP Address [ip_address] Primary internal IP address of the instance.
    Table 5. Instance template [cmdb_ci_instance_template]
    Field Description
    Object ID [object_id] Unique identifier for the instance template.
    Name [name] Name of the instance template.
    Description [short_description] Description of the template configuration.
    Table 6. Cloud Mgmt Network Interface [cmdb_ci_nic]
    Field Description
    Object ID [object_id] Unique identifier combining VM ID and Network Interface Controller (NIC) name.
    Name [name] Name of the network interface.
    Private IP [private_ip] Primary internal IP address.
    IP Address [ip_address] IP address of the network interface.
    Public IP [public_ip] Public IP address of the network interface.
    Table 7. VNIC Endpoint [cmdb_ci_endpoint_vnic]
    Field Description
    Object ID [object_id] Unique identifier for the virtual NIC endpoint.
    Name [name] Name of the virtual NIC endpoint.
    Region [region] Region where the endpoint is located.
    IP Address [ip_address] IP address of the endpoint.
    Table 8. Storage Volume [cmdb_ci_storage_volume]
    Field Description
    Object ID [object_id] Unique identifier for the persistent disk volume.
    Name [name] Name of the disk volume.
    Volume ID [volume_id] Volume identifier.
    Storage type [storage_type] Type of persistent disk.

    For example: pd-balanced, pd-ssd, or pd-standard.
    Size bytes [size_bytes] Size of the volume in bytes.
    State [state] State of the volume.

    For example: Available, In Use, or Terminated.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    Description [short_description] Description of the volume.
    Table 9. Block Endpoint [cmdb_ci_endpoint_block]
    Field Description
    Object ID [object_id] Unique identifier for the block storage endpoint.
    Name [name] Name of the storage endpoint.
    Host [host] VM instance name to which the disk is attached.
    Table 10. Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image]
    Field Description
    Name [name] Name of the operating system (OS) image.
    Object ID [object_id] Unique identifier for the OS image.
    Image Type [image_type] Source type of the image.

    For example: RAW or machine.
    Image Source [image_source] Source of the image in the format: disk_name/disk_id or snapshot_name/snapshot_id.
    FQDN [fqdn] Fully qualified domain name (FQDN) of the image resource.
    Provider [provider] The cloud provider, which is GCP.

    This field is only populated in 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.
    Table 11. Hardware Type [cmdb_ci_compute_template] or Cloud Hardware Type [cmdb_ci_cloud_hardware_type]
    Field Description
    Object ID [object_id] Unique identifier for the machine type.
    Name [name] Name of the machine type.

    For example: n1-standard-4.
    Short description [short_description] Description of the machine type configuration.
    vCPUs [vcpus] Number of vCPUs in the machine type.
    Memory MB [memory_mb] Amount of memory available in the machine type in MB.
    Local storage GB [local_storage_gb] Amount of local storage space in GB.
    Zone [zone] Availability zone where the machine type is available.

    For example: us-west4-b.
    Provider [provider] The cloud provider, which is GCP.

    This field is only populated in Cloud Hardware Type [cmdb_ci_cloud_hardware_type] table.
    Note:
    When using the Hardware Type [cmdb_ci_compute_template] table to store the hardware types, you may notice an unusually large number of records. To avoid this issue, you can store the discovered hardware types in the Cloud Hardware Type [cmdb_ci_cloud_hardware_type] table. For more information, see Enable the Cloud Hardware Type class extension.

    CI relationships

    The Google Cloud Platform (GCP) - Virtual Server pattern creates these relationships to support GCP Virtual Machine discovery.

    CI Relationship CI
    Google Datacenter [cmdb_ci_google_datacenter] Hosted on::Hosts Cloud Service Account [cmdb_ci_cloud_service_account]
    Google Datacenter [cmdb_ci_google_datacenter] Contains::Contained by Availability Zone [cmdb_ci_availability_zone]
    Virtual Machine Instance [cmdb_ci_vm_instance] Hosted on::Hosts Google Datacenter [cmdb_ci_google_datacenter]
    Availability Zone [cmdb_ci_availability_zone] Contains::Contained by Virtual Machine Instance [cmdb_ci_vm_instance]
    Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image] Hosted on::Hosts Cloud Service Account [cmdb_ci_cloud_service_account]
    Hardware Type [cmdb_ci_compute_template] or Cloud Hardware Type [cmdb_ci_cloud_hardware_type] Hosted on::Hosts Google Datacenter [cmdb_ci_google_datacenter]
    Virtual Machine Instance [cmdb_ci_vm_instance] Provisioned From::Provisioned Hardware Type [cmdb_ci_compute_template] or Cloud Hardware Type [cmdb_ci_cloud_hardware_type]
    Instance template [cmdb_ci_instance_template] Hosted on::Hosts Cloud Service Account [cmdb_ci_cloud_service_account]
    Instance template [cmdb_ci_instance_template] Uses::Used by Hardware Type [cmdb_ci_compute_template] or Cloud Hardware Type [cmdb_ci_cloud_hardware_type]
    Instance template [cmdb_ci_instance_template] Uses::Used by Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image]
    VNIC Endpoint [cmdb_ci_endpoint_vnic] Implement End Point To::Implement End Point From Cloud Mgmt Network Interface [cmdb_ci_nic]
    Virtual Machine Instance [cmdb_ci_vm_instance] Use End Point To::Use End Point From VNIC Endpoint [cmdb_ci_endpoint_vnic]
    Cloud Mgmt Network Interface [cmdb_ci_nic] Hosted on::Hosts Google Datacenter [cmdb_ci_google_datacenter]
    Storage Volume [cmdb_ci_storage_volume] Hosted on::Hosts Google Datacenter [cmdb_ci_google_datacenter]
    Availability Zone [cmdb_ci_availability_zone] Contains::Contained by Storage Volume [cmdb_ci_storage_volume]
    Block Endpoint [cmdb_ci_endpoint_block] Implement End Point To::Implement End Point From Storage Volume [cmdb_ci_storage_volume]
    Virtual Machine Instance [cmdb_ci_vm_instance] Use End Point To::Use End Point From Block Endpoint [cmdb_ci_endpoint_block]
    Key Value [cmdb_key_value] References Virtual Machine Instance [cmdb_ci_vm_instance]
    Key Value [cmdb_key_value] References Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image]

    GCP label discovery

    The pattern extension collects labels and populates them in two entries in the Key Value [cmdb_key_value] table. One entry references the Virtual Machine Instance table, the other entry references the Image or Cloud Image table.

    Table 12. Key Value [cmdb_key_value]
    Field Description
    Key [key] Label name.
    Value [value] Label value.
    Configuration item [configuration_item] References the Virtual Machine Instance [cmdb_ci_vm_instance] table.
    Configuration item [configuration_item] References the Image [cmdb_ci_os_template] or Cloud Image [cmdb_ci_cloud_os_image] table.

    GCP BYOL discovery

    The pattern extension section discovers the following license types for Windows and Red Hat Enterprise Linux (RHEL), and SQL Server VMs:
    • Bring Your Own License (BYOL)
    • License included
    The pattern stores the license type and model in the Key Value [cmdb_key_value] table.
    Table 13. Key Value [cmdb_key_value]
    Field Description
    Key [key] The license type key, which is one of the following:
    • Windows_OS_License_Type_automatic
    • RHEL_OS_License_Type_automatic
    • SQL_Server_License_Type_automatic
    Value [value] The license model, which is one of the following:
    • BYOL
    • License Included
    Configuration item [configuration_item] References the Virtual Machine Instance [cmdb_ci_vm_instance] table.