GCP App Engine

Google Cloud Platform (GCP) App Engine is a fully managed, serverless platform for developing and hosting web applications at scale. Cisco Cloud Observability supports monitoring the following App Engine entities:

App Engine: A Cisco AppDynamics entity that represents the GCP application REST resource. An application resource contains the top-level configuration of an App Engine application.
App Engine Service (Standard and flexible): A Cisco AppDynamics entity that merges the GCP service and version REST resources.
- A service resource is a logical component of an application that can share state and communicate in a secure fashion with other services.
- A version resource is a specific set of source code and configuration files that are deployed into a service.
App Engine Instance (Standard and flexible): A Cisco AppDynamics entity that represents the GCP instance REST resource. An instance resource is the computing unit that App Engine uses to automatically scale an application.

You must configure cloud connections to monitor this entity. See Configure Google Cloud Platform Connection.

Cisco Cloud Observability displays GCP entities on the Observe page. Metrics are displayed for specific entity instances in the list and detail views.

This document contains references to third-party documentation. Splunk AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.

Detail View

To display the detail view of an App Engine entity:

Navigate to the Observe page.
Under Containers, click App Engines, App Engine Instances, or App Engine Services.
The list view now displays.
From the list, click an entity Name to display the detail view.
The detail view displays metrics, key performance indicators, and properties (attributes) related to the instance you selected.

Metrics and Key Performance Indicators

Cisco Cloud Observability displays the following metrics and key performance indicators (KPIs) for App Engine entities. See Google Cloud metrics.

Some GCP metrics have been modified in Cisco Cloud Observability. Metric display names and descriptions may differ from the source metric.

Display Name	Source Metric	Description
Memcache Operations (Count)	`memcache/operation_count`	Count of memcache key operations, grouped by command and status. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds.
Memcache Received Bytes (By)	`memcache/received_bytes_count`	Number of bytes received by app from the memcache API, grouped by status and memcache command. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Memcache Sent Bytes (By)	`memcache/sent_bytes_count`	Number of bytes sent by app through the memcache API, grouped by memcache command. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Memcache Used Cache Size (By)	`memcache/used_cache_size`	Size of the cache, calculated as the total size of all items stored. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Memcache Hit Ratio (%)	`memcache/hit_ratio`	Percentage of successful hits compared to all memcache operations. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Memcache Utilization (Mcu)	`memcache/centi_mcu_count`	Memcache utilization in one hundredth of Memcache Compute Unit grouped by command. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.

Metrics may vary depending on your environment. In the following table, the Environment column denotes which environment(s) the metric is available for.

Display Name	Source Metric	Environment	Description
Reserved Cores	`flex/cpu/reserved_cores`	Flexible	Total number of CPU cores allocated to an App Engine flexible environment version. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Disk Bytes (By)	`flex/disk/read_bytes_count` `flex/disk/write_bytes_count`	Flexible	Delta count of bytes read/written from disk across an App Engine flexible environment version. This metric merges two source metrics from GCP.
Quota Denials	`http/server/quota_denial_count`	Standard	Delta count of requests that failed due to the app being over quota. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Responses	`http/server/response_count`	Standard Flexible	Delta HTTP response count. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Response Latency (ms)	`http/server/response_latencies`	Standard Flexible	HTTP response latency. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Estimated Instances	`system/billed_instance_estimate_count`	Standard	Estimate of the number of instances that the customer is charged for. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
CPU Megacycles (Mcs)	`system/cpu/usage`	Standard	CPU usage in megacycles over all instances. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
Memory Usage (By)	`system/memory/usage`	Standard Flexible	Total memory used by running instances. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
(System) Network Throughput (By)	`system/network/received_bytes_count` `system/network/sent_bytes_count`	Standard Flexible	Delta count of incoming/outgoing network bandwidth. This metric merges two source metrics from GCP.
Connections	`flex/connections/current`	Flexible	Number of current active connections per App Engine flexible environment version. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
CPU Utilization (%)	`flex/cpu/utilization`	Flexible	Fractional utilization of allocated CPU across an App Engine flexible environment version. Values are typically numbers between 0.0 and 1.0 (but some machine types allow bursting above 1.0). Charts display the values as a percentage between 0% and 100% (or more). Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
(Flex) Network Throughput (By)	`flex/network/received_bytes_count` `flex/network/sent_bytes_count`	Flexible	Delta count of incoming/outgoing network bytes across all VMs in an App Engine flexible environment version. This metric merges two source metrics from GCP.

GCP App Engine Instance metrics are only available for flexible environments.

Display Name	Source Metric	Description
Connections	`flex/instance/connections/current`	Number of current active connections per App Engine flexible environment instance. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
CPU Utilization (%)	`flex/instance/cpu/utilization`	Fractional CPU utilization for all cores on a single App Engine flexible instance. Values are typically numbers between 0.0 and 1.0 for a single core (but might exceed 1.0 in total). Charts display the values as a percentage between 0% and 100% (or more). Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.
(Flex) Network Throughput (By)	`flex/instance/network/received_bytes_count` `flex/instance/network/sent_bytes_count`	The delta count of incoming and outgoing network bytes in an App Engine flexible instance. This metric merges two source metrics from GCP.
Websocket Average Duration (s)	`flex/instance/ws/avg_duration`	Average of websocket requests for a given App Engine Flexible instance. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds.

Properties (Attributes)

Cisco Cloud Observability displays the following properties for App Engine entities.

Display Name	Source Property Name	Description
Provider	-	The name of the cloud provider. The value of this property is the `gcp` string, hardcoded.
Project ID	-	The ID of the GCP project.
Platform	-	The name of the cloud platform. The value of this property is the `gcp_app_engine` string, hardcoded.
Region	`locationId`	The geographical region where the resource is running.
ID	`name`	The full path to the application resource in the API. Example: `apps/{application-name=project-id}`
Name	`id`	The identifier of the application resource. This value is equivalent to the project ID of the GCP project where you want to deploy your application.
Status	`servingStatus`	The serving status of the application. It is an enumerated type with the following possible values: `UNSPECIFIED` `SERVING` `USER_DISABLED` `SYSTEM_DISABLED`
Database Type	`databaseType`	The type of the database associated with the application. The possible values are: `DATABASE_TYPE_UNSPECIFIED` `CLOUD_DATASTORE` `CLOUD_FIRESTORE` `CLOUD_DATASTORE_COMPATIBILITY`

GCP App Engine Service is a Cisco AppDynamics entity that merges the GCP service and version REST resources. Properties for this entity are derived from the GCP service, version, and application resources. In the following table, the Source Resource column denotes the source resource for each property.
Properties may vary depending on your environment. In the following table, the Environment column denotes what environment(s) the property is available for.

Display Name	Environment	Source Property Name	Source Resource	Description
Provider	Standard Flexible	-	-	The name of the cloud provider. This value is the `gcp` string, hardcoded.
Project ID	Standard Flexible	-	-	The ID of the GCP project.
Platform	Standard Flexible	-	-	The name of the platform. This value is the `gcp_app_engine_service` string, hardcoded.
Region	Standard Flexible	`locationId`	Application	The geographical region where the resource is running.
Service ID	Standard Flexible	`name`	Service	The ID of the service where the version was deployed.
Service Name	Standard Flexible	`id`	Service	The name of the service where the version was deployed.
Version ID	Standard Flexible	`name`	Version	The full path to the `version` resource in the API. Example: `apps/myapp/services/default/versions/v1`
Application ID	Standard Flexible	`name`	Application	The reference to the application this version belongs to.
Version Name	Standard Flexible	`id`	Version	The relative name of the version within the service. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: `default`, `latest`, and any name with the prefix `ah-`.
Name	Standard Flexible	-	Service Version	The name of this service. It is a concatenation between the service name and version name.
Creation Time	Standard Flexible	`createTime`	Version	The time that this version was created.
Created By	Standard Flexible	`createdBy`	Version	The email address of the user who created this version.
Status	Standard Flexible	`servingStatus`	Version	The current serving status of this version. Only versions with a `SERVING` status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is an invalid value. Defaults to `SERVING`.
Runtime	Standard Flexible	`runtime`	Version	The desired runtime. Example: `python27`.
Runtime Version	Standard Flexible	`runtimeApiVersion`	Version	The version of the API in the given runtime environment.
Version URL	Standard Flexible	`versionUrl`	Version	The serving URL for this version.
Environment	Standard Flexible	`env`	Version	The App Engine execution environment for this version. Defaults to `standard`.
Threadsafe	Standard Flexible	`threadsafe`	Version	Defines if multiple requests can be dispatched to this version at the same time.
Disk Usage Bytes (By)	Standard Flexible	`diskUsageBytes`	Version	The total size in bytes of all the files that are included in this version and currently hosted on the app engine disk.
Instance Class	Standard Flexible	`instanceClass`	Version	The Instance class that is used to run this version. The valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling = B1, B2, B4, B8, B4_1G The default values are F1 for AutomaticScaling and B1 for ManualScaling/BasicScaling.
Network Name	Flexible	`network.name`	Version	The Google Compute Engine network where the virtual machines are created. Specify the short name, not the resource path.
Subnetwork Name	Flexible	`network.subnetworkName`	Version	The GCP sub-network where the virtual machines are created. Specify the short name, not the resource path.
Resources CPU	Flexible	`resources.cpu`	Version	The number of CPU cores needed.
Resources Memory (GB)	Flexible	`resources.memoryGb`	Version	The memory (GB) needed.
Resources Disk (GB)	Flexible	`resources.diskGb`	Version	The disk size (GB) needed.

Properties for this entity are derived from the GCP instance, version, and application resources. In the following table, the Source Resource column denotes the source resource for each property.
Properties may vary depending on your environment. In the following table, the Environment column denotes what environment(s) the property is available for.

Display Name	Environment	Source Property Name	Source Resource	Description
Provider	Standard Flexible	-	-	The name of the cloud provider. This value is the `gcp` string, hardcoded.
Project ID	Standard Flexible	-	-	The ID of the GCP project.
Platform	Standard Flexible	-	-	The cloud platform. This value is the `gcp_app_engine_instance` string, hardcoded.
Region	Standard Flexible	`locationId`	Application	The region where the instance is deployed.
Environment	Standard Flexible	-	Version	The App Engine execution environment for this instance.
ID	Standard Flexible	`name`	Instance	The full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`
Name	Standard Flexible	`id`	Instance	The relative name of the instance within the version. Example: `instance-1`
Start Time	Standard Flexible	`startTime`	Instance	The time that this instance was started.
Zone	Flexible	`vmZoneName`	Instance	The zone where the instance is deployed.
Public IP	Flexible	`vmIp`	Instance	The virtual machine ID of the instance. Only applicable for instances in App Engine flexible environments.
Status	Flexible	`vmStatus`	Instance	The status of the virtual machine where the instance lives. Only applicable for instances in app engine flexible environments.
Errors	Standard	`errors`	Instance	The number of errors since the instance was started.
Memory Usage (By)	Standard	`memoryUsage`	Instance	The total memory in use (bytes).
Requests	Standard	`requests`	Instance	The number of requests since the instance was started.
Average Latency (ms)	Standard	`averageLatency`	Instance	The average latency (ms) over the last minute.

Retention and Purge Time-To-Live (TTL)

For all cloud and infrastructure entities, the retention TTL is 180 minutes (3 hours) and the purge TTL is 525,600 minutes (365 days).

Third party names, logos, marks, and general references used in these materials are the property of their respective owners or their affiliates in the United States and/or other countries. Inclusion of such references are for informational purposes only and are not intended to promote or otherwise suggest a relationship between Splunk AppDynamics and the third party.