Google Cloud Platform (GCP) Monitoring (Pre-Release)

uimpga-ga
HID_RESTMON_GCP
This documentation is pre-release information and is subject to change or withdrawal by Broadcom at any time until the actual GA date which remains at the sole discretion of Broadcom. Please check this space for the updated documentation when the GA happens.
Google Cloud Platform offers services for compute, storage, networking, big data, machine learning, and the Internet of Things (IoT), as well as cloud management, security, and developer tools.
With Google Cloud Platform (GCP) Monitoring using RestMon, you can monitor the health and performance of available services in GCP. You can always monitor your GCP user account and retrieve all the service data from GCP. You can generate Quality of Service (QoS) data and can get availability status alarms.
For more information about supported GCP services, see Supported GCP Services.
The following diagram outlines the process to configure the GCP Monitoring using RESTMon.
This article contains the following topics:
Prerequisite & Probe Specific Requirements
Verify the following information before you create a monitoring configuration profile:
  • Make sure that you are on UIM Server 20.3.3 (or above), and OC 20.3.3 (or above)
  • The following dependent packages can be downloaded from the Broadcom Support site
    • robot_update
    • ump_operatorconsole webapp
    • mcs-ui-app-portlet
    • ci_defn_pack
    • mps_language_pack
    • restmon_gcp_schemas
    • restmon probe
Google Cloud Platform (GCP) Schema and Template
Download the GCP schema bundle (
restmon_gcp_schemas.zip
) from the Broadcom Support site. This schema bundle comprises a config schema and the supported service schemas.
Config Schema:
  • gcp_config_schema.json
    Config Schema is used to enter serviceaccount and access key details to connect to GCP APIs. You must configure the Setup GCP Config profile before configuring the GCP Service profiles. You must fill the following details while configuring the Config profile:
    • Active
      Select Active to enable this profile.
    • Profile Name
      Enter a unique name for this profile.
    • Interval (Seconds)
      Specify how often the REST endpoints are polled in seconds
    • Check Certificate
      Check this box to enable checking of the SSL certificate.
    • Hostname or Domain Name
      Enter the hostname or the domain name of the GCP Config's monitoring API URL.
    • Port
      Specify the port number used to access the GCP Config's monitoring API URL.
    • Client ID
      Specify the client_id for the account with authorization to connect to the GCP Config's monitoring API URL.
    • Client Email
      Specify the client_secret_id for the account with authorization to connect to the GCP Config's monitoring API URL.
    • Private Key
      Specify the client_secret for the account with authorization to connect to the GCP Config's monitoring API URL.
    • Project Id
      Specify the project_id for the account with authorization to connect to the GCP Config's monitoring API URL.
    • HTTP Timeout
      Specify the http timeout.
Service Schemas:
  • gcp_compute_engine_schema.json
  • gcp_filestore_schema.json
  • gcp_vpc_schema.json
  • gcp_storage_schema.json
  • gcp_billing_schema.json
  • gcp_interconnect_schema.json
  • gcp_cloud_routers_schema.json
  • gcp_kubernetes_engine_schema.json
For the upgrade path of the GCP Schemas, do not modify the Schemas.
Create Setup GCP Config Profile
Upload the GCP schemas (one schema at a time) using the
Operator Console
->
Settings
->
RESTMon
.
After you upload the schema, it gets converted into a template and you can create profiles in multiple ways in the
Operator Console
.
To monitor the services in Google Cloud Platform (GCP), create the Setup GCP profile from the
Monitoring
tab in Operator Console
and then configure the service-specific profiles for monitoring.
You can configure the MCS profile configuration in three approaches using the Operator Console:
  • By selecting any device in the Inventory view.
    Both Bus and Account Contact users with USM Monitoring Configuration Service ACL permissions can configure MCS profiles using this approach.
  • By selecting any group in the Groups view.
    Both Bus and Account Contact users with USM Monitoring Configuration Service ACL permissions can configure MCS profiles using this approach.
  • Using the Remote and Cloud Monitoring in the Setup Wizard.
    Only Bus users with USM Monitoring Configuration Service ACL permissions can configure MCS profiles using this approach.
Follow these steps:
  • Create Monitoring from the Inventory View:
    1. In the Operator Console (OC), hover the cursor over the popup menu on the left side of the page, then click on Inventory view. Select a device.
    2. Click on
      Monitoring config
      icon on the right side of the page.
  • Create Monitoring from the Groups View:
    1. In the Operator Console (OC), hover the cursor over the popup menu on the left side of the page, then click on Group view. Expand an OC group and select the robot that is identified for GCP Monitoring.
    2. Click on
      Monitoring config
      icon on the right side of the page.
    3. Click '
      +
      '  icon to create new MCS profile.
    4. Choose
      Setup GCPConfig
      profile type name.
  • Create Monitoring from the Setup Wizard:
    1. In the Operator Console (OC), hover the cursor over the popup menu on the left side of the page, then click on Setup Wizard. Select "Remote And Cloud".
    2. Click on
      + ADD
      icon to add monitoring profile for the GCP Config which is available in the
      Applications
      section of
      Setup Infrastructure Monitoring
      .
    3. Click on the setup available for the Google Cloud Platform (GCP) probe:
      Setup GCPConfig
      For schemas, the template name is taken from the friendly name that you define while uploading the schema in Operator Console.
    4. For monitoring the GCP services, add the same authentication details that are used for your GCP service account. For more details about the service account authentication, see the GCP Service Account Authentication.
Create GCP Service Profiles for Monitoring
Once you have completed configuring the GCP Setup Profile, you must create the desired Service monitoring profile using Operator Console.
To create a GCP services monitoring profile, follow these steps:
  1. Upload the supported GCP service schema using the
    Operator Console
    ->
    Settings
    ->
    RESTMon
    .
    While uploading the Service schemas using the Operator Console, you can provide the Service name as friendly name in the Friendly Name field. Example - Google Compute Engine.
  2. Create the monitoring profile for the GCP Service using the following ways in the Operator Console:
    • Inventory View
    • Groups View
    • Setup Wizard
  3. Select and configure the required service-profile.
  4. Activate or deactivate the required metrics while configuring the monitoring.
While creating the GCP services profiles, provide the same
Client ID
which is used while creating the GCP Setup Profile.
If you want to configure alarm thresholds from the metrics selection page, configure the
policy_mode_enabled
parameter in the MCS configuration file and set the value as
false
. Once you set the parameter, the following section appears for metrics and alarms configuration:
Metric Collection and Alarm Definition
For more information about configuring alarm thresholds, see Configuring Alarm Thresholds in MCS. Alternatively, you can create alarm policies and can configure thresholds from the Operator Console. For more information about creating alarm policies, see Manage Alarms with Centralized Alarm Policies.
GCP Service Account Authentication
For using the GCP monitoring, you must add the authentication details while configuring the Setup GCP Config.
Follow these steps to get the GCP service account key that is used while configuring the authentication details.
  1. Create a GCP Service account, see Creating and Managing Service Accounts for more information.
  2. Create Service account key, see Creating and Managing Service Account Keys for more information.
  3. Download the key and make note of the following parameter values to use while configuring Setup GCP Config.
    • client_id
    • client_email
    • private_key
  4. Add these values in the Setup GCP Config template while creating the profile.
Auto-grouping
Using the Auto-grouping feature, you can group the GCP resources that are based on the GCP Service type automatically. insert into CM_GROUP_AUTOMATIC (field, parent, grp_type) values('UserProp.GCPProjectId', ‘GCP Projects', 2);  This feature is to avoid the creation of the groups manually in the Operator Console. You can define the automatic group settings in the cm_group_automatic table.
For Auto-grouping of the GCP resources based on the GCP service type, run the following sql command from your preferred database client or using the SQL Editor in SLM. You must perform "COMMIT" for Oracle and MySQL databases after executing this command.
insert into CM_GROUP_AUTOMATIC (field, parent, grp_type) values('UserProp.GCPService', 'Google Cloud', 2);
For Auto-grouping of the GCP resources based on the GCP Projects, run the following sql command from your preferred database client or using the SQL Editor in SLM. You must perform "COMMIT" for Oracle and MySQL databases after executing this command.
insert into CM_GROUP_AUTOMATIC (field, parent, grp_type) values('UserProp.GCPProjectId', ‘GCP Projects', 2);
For Auto-grouping of the GCP resources based on the GCP Regions, run the following sql command from your preferred database client or using the SQL Editor in SLM. You must perform "COMMIT" for Oracle and MySQL databases after executing this command.
insert into CM_GROUP_AUTOMATIC (field, parent, grp_type) values('UserProp.GCPRegion', ‘GCP Regions, 2);
Related topics
: