Introduction

Google Cloud Vertex AI is a unified machine learning platform for building, deploying, and scaling machine learning models and generative AI applications. OpsRamp discovers and monitors Vertex AI resources, including endpoints, deployed models, models and model versions, pipeline jobs, feature online stores, indexes, index endpoints, and reasoning engines. It also collects Cloud Monitoring metrics from the aiplatform.googleapis.com service, providing visibility into resource health, performance, and utilization.

Use the Google Cloud integration to discover Vertex AI resources and collect associated performance and operational metrics.

Setup

Before discovering Vertex AI resources, ensure that the OpsRamp Google Cloud (GCP) Integration is configured.

To enable Vertex AI resource discovery, select the Vertex AI resource types in the GCP Integration Discovery Profile.

OpsRamp collects metrics from Google Cloud Monitoring under the aiplatform.googleapis.com metric domain.

Ensure that the integration service account has the following permissions:

  • aiplatform.*.list
  • aiplatform.*.get
  • monitoring.timeSeries.list

Supported resource types

Resource Type (Native Type)Resource TagDescription
GCP Vertex AI EndpointGCP_VERTEX_ENDPOINTOnline prediction endpoints serving deployed models.
GCP Vertex AI Deployed ModelGCP_VERTEX_DEPLOYED_MODELA model deployed to an endpoint for serving.
GCP Vertex AI ModelGCP_VERTEX_MODELRegistered models in the Vertex AI Model Registry.
GCP Vertex AI Model VersionGCP_VERTEX_MODEL_VERSIONIndividual versions of a registered model.
GCP Vertex AI Pipeline JobGCP_VERTEX_PIPELINE_JOBVertex AI Pipelines execution runs.
GCP Vertex AI Feature Online StoreGCP_VERTEX_FEATURE_STOREFeature online stores for low-latency serving.
GCP Vertex AI IndexGCP_VERTEX_INDEXVector Search indexes.
GCP Vertex AI Index EndpointGCP_VERTEX_INDEX_ENDPOINTEndpoints serving deployed Vector Search indexes.
GCP Vertex AI Reasoning EngineGCP_VERTEX_REASONING_ENGINEManaged runtime for agent reasoning and memory.

Supported metrics

Endpoint

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_endpoint_prediction_online_accelerator_duty_cycleprediction/online/accelerator/duty_cycleAccelerator duty cycle%AverageAverage fraction of time the accelerator(s) were actively processing.
google_vertex_endpoint_prediction_online_accelerator_memory_bytes_usedprediction/online/accelerator/memory/bytes_usedAccelerator memory usagecountAverageAmount of accelerator memory allocated to the deployed model replica.
google_vertex_endpoint_prediction_online_cpu_utilizationprediction/online/cpu/utilizationCPU Utilization%AverageFraction of CPU allocated by the deployed model replica and currently in use.
google_vertex_endpoint_prediction_online_error_countprediction/online/error_countError countcountSumNumber of online prediction errors.
google_vertex_endpoint_prediction_online_machine_countprediction/online/machine_countMachine countcountAverageNumber of machines used by the deployed model.
google_vertex_endpoint_prediction_online_memory_bytes_usedprediction/online/memory/bytes_usedMemory usagecountAverageAmount of memory allocated to the deployed model replica and currently in use.
google_vertex_endpoint_prediction_online_network_received_bytes_countprediction/online/network/received_bytes_countNetwork bytes receivedcountSumBytes received over the network by the deployed model replica.
google_vertex_endpoint_prediction_online_network_sent_bytes_countprediction/online/network/sent_bytes_countNetwork bytes sentcountSumBytes sent over the network by the deployed model replica.
google_vertex_endpoint_prediction_online_prediction_countprediction/online/prediction_countPrediction countcountSumNumber of online predictions.
google_vertex_endpoint_prediction_online_prediction_latenciesprediction/online/prediction_latenciesPrediction LatenciesmsAverageOnline prediction latency of the deployed model.
google_vertex_endpoint_prediction_online_private_prediction_latenciesprediction/online/private/prediction_latenciesPrivate endpoint prediction latenciesmsAverageOnline prediction latency of the private deployed model.
google_vertex_endpoint_prediction_online_private_response_countprediction/online/private/response_countPrivate endpoint response countcountSumNumber of online prediction responses for the private deployed model.
google_vertex_endpoint_prediction_online_replicasprediction/online/replicasReplica countcountAverageNumber of active replicas used by the deployed model.
google_vertex_endpoint_prediction_online_response_countprediction/online/response_countResponse countcountSumNumber of different online prediction response codes.
google_vertex_endpoint_prediction_online_target_replicasprediction/online/target_replicasReplica targetcountAverageTarget number of active replicas needed for the deployed model.
google_vertex_endpoint_tuned_model_online_serving_consumed_token_throughputtuned_model/online_serving/consumed_token_throughputToken ThroughputcountSumOverall throughput in terms of tokens for GenAI tuned models.
google_vertex_endpoint_tuned_model_online_serving_first_token_latenciestuned_model/online_serving/first_token_latenciesFirst token latenciesmsAverageDuration from request received to first token sent back for GenAI tuned models.
google_vertex_endpoint_tuned_model_online_serving_model_invocation_latenciestuned_model/online_serving/model_invocation_latenciesModel invocation latenciesmsAverageModel invocation latencies for fine-tuned GenAI models.
google_vertex_endpoint_tuned_model_online_serving_tokenstuned_model/online_serving/tokensTokenscountAverageInput and output token count distribution for GenAI tuned models.

Model

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_model_feature_attribution_deviationmodel_monitoring/feature_attribution_deviationFeature Attribution DeviationcountAverageThe feature attribution deviation value of the given feature.
google_vertex_model_feature_drift_deviationmodel_monitoring/feature_drift_deviationFeature Drift DeviationcountAverageThe drift deviation value of the given feature.
google_vertex_model_prediction_output_drift_deviationmodel_monitoring/prediction_output_drift_deviationPrediction Output Drift DeviationcountAverageThe drift deviation value of the prediction output.

Index Endpoint

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_matching_engine_query_request_countmatching_engine/query/request_countQuery Request CountcountSumNumber of requests received by matching engine.
google_vertex_matching_engine_query_latenciesmatching_engine/query/latenciesQuery LatenciesmsDistributionServer side query latency.
google_vertex_matching_engine_current_replicasmatching_engine/current_replicasCurrent ReplicascountGaugeNumber of active replicas used by the DeployedIndex.
google_vertex_matching_engine_current_shardsmatching_engine/current_shardsCurrent ShardscountGaugeNumber of shards of the DeployedIndex.
google_vertex_matching_engine_cpu_request_utilizationmatching_engine/cpu/request_utilizationCPU Request Utilization%GaugeCPU utilization of match server containers.
google_vertex_matching_engine_memory_used_bytesmatching_engine/memory/used_bytesMemory Used BytescountGaugeMemory used by match server container.

Feature Online Store

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_featureonlinestore_online_serving_request_countfeatureonlinestore/online_serving/request_countRequest CountcountSumNumber of online serving requests received.
google_vertex_featureonlinestore_serving_bytes_countfeatureonlinestore/online_serving/serving_bytes_countServing Bytes CountcountSumResponse bytes count from Feature Online Store.
google_vertex_featureonlinestore_online_serving_latenciesfeatureonlinestore/online_serving/serving_latenciesOnline Serving LatenciesmsAverageOnline serving latencies for Feature Online Store.
google_vertex_featureonlinestore_running_syncfeatureonlinestore/running_syncRunning SynccountGaugeNumber of running syncs at a given time.
google_vertex_featureonlinestore_serving_data_agesfeatureonlinestore/serving_data_agesServing Data AgesDistributionGaugeAge of serving data in seconds.
google_vertex_featureonlinestore_serving_data_by_sync_timefeatureonlinestore/serving_data_by_sync_timeServing Data By Sync TimecountGaugeBreakdown of serving data by sync time.
google_vertex_featureonlinestore_bigtable_cpu_loadfeatureonlinestore/storage/bigtable_cpu_loadBigtable CPU Load%GaugeAverage CPU load of Bigtable nodes.
google_vertex_featureonlinestore_bigtable_cpu_load_hottest_nodefeatureonlinestore/storage/bigtable_cpu_load_hottest_nodeBigtable Hottest Node CPU Load%GaugeCPU load of hottest Bigtable node.
google_vertex_featureonlinestore_bigtable_nodesfeatureonlinestore/storage/bigtable_nodesBigtable NodescountGaugeNumber of Bigtable nodes.
google_vertex_featureonlinestore_multi_region_bigtable_cpu_loadfeatureonlinestore/storage/multi_region_bigtable_cpu_loadMulti-region Bigtable CPU Load%GaugeCPU load of the multi-region Bigtable instance.
google_vertex_featureonlinestore_multi_region_bigtable_nodesfeatureonlinestore/storage/multi_region_bigtable_nodesMulti-region Bigtable NodescountGaugeNode count for multi-region Bigtable.
google_vertex_featureonlinestore_optimized_nodesfeatureonlinestore/storage/optimized_nodesOptimized NodescountGaugeNumber of optimized nodes.
google_vertex_featureonlinestore_stored_bytesfeatureonlinestore/storage/stored_bytesStored BytescountGaugeBytes stored in Feature Online Store.

Pipeline Job

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_pipelinejob_durationpipelinejob/durationPipeline Job DurationmsAveragePipeline job run duration.
google_vertex_pipelinejob_task_completed_countpipelinejob/task_completed_countPipeline Task Completed CountcountSumNumber of completed pipeline tasks.

Index

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_index_stream_update_datapoint_countmatching_engine/stream_update/datapoint_countDatapoint CountcountSumNumber of successfully upserted or removed datapoints.
google_vertex_index_stream_update_latenciesmatching_engine/stream_update/latenciesStream Update LatenciesmsAverageLatency between the user receiving a response and that update taking effect.
google_vertex_index_stream_update_request_countmatching_engine/stream_update/request_countRequest CountcountSumNumber of stream update requests.

Reasoning Engine

OpsRamp MetricGCP MetricMetric Display NameUnitAggregation TypeDescription
google_vertex_reasoning_engine_cpu_allocation_timereasoning_engine/cpu/allocation_timeContainer CPU AllocationsecondsSumContainer CPU allocation in seconds.
google_vertex_reasoning_engine_memory_allocation_timereasoning_engine/memory/allocation_timeContainer Memory AllocationGB-secondsSumContainer memory allocation in Gigabytes-seconds.
google_vertex_reasoning_engine_generate_memories_token_countreasoning_engine/memory_bank/generate_memories_token_countGenerate Memories Token CountcountSumNumber of tokens used in memory generation requests per Reasoning Engine.
google_vertex_reasoning_engine_memory_lro_latencyreasoning_engine/memory_bank/memory_lro_latencyMemory LRO LatencymsAverageTotal latency of memory LROs.
google_vertex_reasoning_engine_memory_mutation_countreasoning_engine/memory_bank/memory_mutation_countMemory Mutation CountcountSumNumber of memory mutation operations on the Reasoning Engine.
google_vertex_reasoning_engine_memory_retrieval_countreasoning_engine/memory_bank/memory_retrieval_countRetrieved Memories CountcountSumNumber of memory entities retrieved per Reasoning Engine.
google_vertex_reasoning_engine_request_countreasoning_engine/request_countRequest CountcountSumNumber of requests reaching the instance.
google_vertex_reasoning_engine_request_latenciesreasoning_engine/request_latenciesRequest LatencymsAverageDistribution of request latency in milliseconds reaching the instance.

External reference