Bindplane

The Bindplane Developer Hub

Welcome to the Bindplane developer hub. You'll find comprehensive guides and documentation to help you start working with Bindplane as quickly as possible, as well as support if you get stuck. Let's jump right in!

Google Cloud App Engine

Monitor Google Cloud App Engine Web and Compute Hosting Platform

Not Included in the BindPlane with Google Stackdriver offering

All of the Google Cloud Platform sources listed within this documentation are not included with the BindPlane with Google Stackdriver offering.

For more information on how to use the below LPU and other Google Cloud Data Collection setup. See the Google Cloud Platform Sources

Least Privileged User

A user role with the following permissions are required:

Deploying the Least Privileged User

To learn more about how to deploy a role with these permissions to a GCP Organization, or a GCP Project, please refer to this documentation:
Deploy an Individual LPU role to a GCP Project, or GCP Organization

- cloudnotifications.activities.list
- monitoring.alertPolicies.get
- monitoring.alertPolicies.list
- monitoring.dashboards.get
- monitoring.dashboards.list
- monitoring.groups.get
- monitoring.groups.list
- monitoring.metricDescriptors.get
- monitoring.metricDescriptors.list
- monitoring.monitoredResourceDescriptors.get
- monitoring.monitoredResourceDescriptors.list
- monitoring.notificationChannelDescriptors.get
- monitoring.notificationChannelDescriptors.list
- monitoring.notificationChannels.get
- monitoring.notificationChannels.list
- monitoring.publicWidgets.get
- monitoring.publicWidgets.list
- monitoring.timeSeries.list
- monitoring.uptimeCheckConfigs.get
- monitoring.uptimeCheckConfigs.list
- resourcemanager.projects.get
- resourcemanager.projects.list
- stackdriver.projects.get
- appengine.applications.get
- appengine.instances.get
- appengine.instances.list
- appengine.operations.get
- appengine.operations.list
- appengine.services.get
- appengine.services.list
- appengine.versions.get
- appengine.versions.list

Connection Parameters

Name
Required?
Description

Private Key JSON

Required

The contents of the private key JSON file created when setting up a service account.

Metric Collection

Controls which metrics get requested from GCP's Stackdriver API.

Projects

Required

A comma separated whitelist of project IDs. If the wildcard "*" is used, resources will be collected from all available projects.

Connection Timeout

The number of seconds to allow for connecting to the target.

Metrics

App

Name
Description

Auth Domain

Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account.

Checks Content Mismatch (%)

Ratio of responses that had content that did not match the check.

Checks Passed (%)

Ratio of checks passed.

Code Bucket

Google Cloud Storage bucket that can be used for storing files associated with this application.

CPU Megacycles

CPU usage in megacycles.

CPU Utilization (%)

The allocated CPU in use across an App Engine flexible environment version. Note that some machine types allow bursting above 100%.

Default Bucket

Google Cloud Storage bucket that can be used by this application to store content.

Default Cookie Expiration (Seconds)

Cookie expiration policy for this application.

Default Hostname

Hostname used to reach this application, as resolved by App Engine.

Delta of Serve Style Response

Delta count of responses on the HTTP serve style.

Disk Data Read (Bytes per Second)

Rate of data read from disk across an App Engine flexible environment version.

Disk Data Written (Bytes per Second)

Rate of data written from disk across an App Engine flexible environment version.

Enabled

Whether the serving infrastructure will authenticate and authorize all incoming requests.

GCR Domain

The Google Container Registry domain used for storing managed build docker images for this application.

Instance Count

Number of instances that exist.

Interception Count

Delta count of interceptions performed to prevent DoS attacks.

Location ID

Location from which this application runs. Application instances run out of the data centers in the specified location, which is also where all of the application's end user content is stored. Defaults to us-central.

Memcache Operations

Count of memcache key operations, grouped by command and status.

Memcache Received Data (Bytes)

Amount of data received by app from the memcache API.

Memcache Sent Data (Bytes)

Amount of data sent by app through the memcache API, grouped by memcache command.

Memcache Utilization

Memcache utilization in one hundredth of Memcache Compute Unit.

Memory Usage (Bytes)

Total memory used by running instances.

Network Data Received (Bytes per Second)

Rate of incoming network data across all VMs in an App Engine flexible environment version.

Network Data Sent (Bytes per Second)

Rate of outgoing network data across all VMs in an App Engine flexible environment version.

Oauth2 Client ID

OAuth2 client ID to use for the authentication flow.

Oauth2 Client Secret

OAuth2 client secret to use for the authentication flow.

Oauth2 Client Secret Sha256

Hex-encoded SHA-256 hash of the client secret.

Project ID

The identifier of the GCP project associated with this resource.

Quota Denial Count

Delta count of requests that failed due to the app being over quota.

Received Data (Bytes)

Delta count of incoming network bandwidth.

Reserved CPU (Cores)

Total amount of CPU allocated to an App Engine flexible environment version.

Response Count

Delta HTTP response count.

Response Latency (Milliseconds)

HTTP response latency.

Sent Data (Bytes)

Delta count of outgoing network bandwidth.

Serving Status

Serving status of this application.

Split Health Checks

Indicates if split health checks should be used instead of the legacy health checks.

Authorized Certificates

Name
Description

Certificate Raw Data Private Key

Unencrypted PEM encoded RSA private key.

Certificate Raw Data Public Certificate

PEM encoded x.509 public key certificate.

Display Name

The user-specified display name of the certificate.

Domain Mappings Count

Aggregate count of the domain mappings with this certificate mapped. This count includes domain mappings on applications for which the user does not have VIEWER permissions. Only returned by GET or LIST requests when specifically requested by the view=FULL_CERTIFICATE option.

Domain Names

Topmost applicable domains of this certificate. This certificate applies to these domains and their subdomains.

Expire Time

The time when this certificate expires.

ID

Unique name of the certificate.

Name

Full path to the AuthorizedCertificate resource in the API. Example: apps/myapp/authorizedCertificates/12345.

Project ID

The project ID in which this resource was created.

Visible Domain Mappings

The full paths to user visible Domain Mapping resources that have this certificate mapped. Example: apps/myapp/domainMappings/example.com. This may not represent the full list of mapped domain mappings if the user does not have VIEWER permissions on all of the applications that have this certificate mapped. See domainMappingsCount for a complete count.

Authorized Domains

Name
Description

ID

Fully qualified domain name of the domain authorized for use.

Name

Full path to the AuthorizedDomain resource in the API. Example: apps/myapp/authorizedDomains/example.com.

Domain Mapping

Name
Description

ID

Relative name of the domain serving the application. Example: example.com.

Name

Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.

Project ID

The project ID in which this resource was created.

Resource Records Data

Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).

Resource Records Name

Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.

Resource Records Type

Resource record type.

SSL Settings Certificate ID

ID of the AuthorizedCertificate resource configuring SSL for the application.

Firewall Ingress Rules

Name
Description

Action

The action to take on matched requests.

Description

A Description of this rule.

Priority

A positive integer between [1, Int32.MaxValue-1] that defines the order of rule evaluation. Rules with the lowest priority are evaluated first. A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches.

Project ID

The project ID in which this resource was created.

Source Range

IP address or range, defined using CIDR notation, of requests that this rule applies to.

Instance

Name
Description

App Engine Release

App Engine release this instance is running on.

Availability

Availability of the instance.

Average Latency (Milliseconds)

Average latency over the last minute.

Errors (Errors)

Number of errors since this instance was started.

ID

Relative name of the instance within the version. Example: instance-1.

Memory Usage (Bytes)

Total memory in use.

Name

Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.

Project ID

The project ID in which this resource was created.

Query Rate (per Second)

Average rate of queries over the last minute.

Requests (Requests)

Number of requests since this instance was started.

Start Time

Time that this instance was started.

VM Debug Enabled

Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.

VM ID

Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.

VM IP

The IP address of this instance. Only applicable for instances in App Engine flexible environment.

VM Name

Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.

VM Status

Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.

VM Zone Name

Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.

Service

Name
Description

Checks Content Mismatch (%)

Ratio of responses that had content that did not match the check.

Checks Passed (%)

Ratio of checks passed.

CPU Megacycles

CPU usage in megacycles.

CPU Utilization (%)

The amount of allocated CPU in use across an App Engine flexible environment version. Note that some machine types allow bursting above 100%.

Delta of Serve Style Response (per Second)

Delta counts on the HTTP serve style.

Disk Data Read (Bytes per Second)

Rate of data read from disk across an App Engine flexible environment version.

Disk Data Written (Bytes per Second)

Rate of data written from disk across an App Engine flexible environment version.

Instance Count

Number of instances that exist.

Interception Count

Delta count of interceptions performed to prevent DoS attacks.

Memcache Operations

Count of memcache key operations, grouped by command and status.

Memcache Received Data (Bytes)

Amount of data received by app from the memcache API.

Memcache Sent Data (Bytes)

Amount of data sent by app through the memcache API, grouped by memcache command.

Memcache Utilization

Memcache utilization in one hundredth of Memcache Compute Unit.

Memory Usage (Bytes)

Total memory used by running instances.

Module ID

The service/module name.

Network Data Received (Bytes per Second)

Rate of incoming network data across all VMs in an App Engine flexible environment version.

Network Data Sent (Bytes per Second)

Rate of outgoing network data across all VMs in an App Engine flexible environment version.

Project ID

The identifier of the GCP project associated with this resource.

Quota Denial Count

Delta count of requests that failed due to the app being over quota.

Received Data (Bytes)

Delta count of incoming network bandwidth.

Reserved CPU (Cores)

Total amount of CPU allocated to an App Engine flexible environment version.

Response Count

Delta HTTP response count.

Response Latency (Milliseconds)

HTTP response latency.

Sent Data (Bytes)

Delta count of outgoing network bandwidth.

Split Allocations

Mapping from version IDs within the service to fractional (0.000, 1] allocations of traffic for that version. Each version can be specified only once, but some versions in the service may not have any traffic allocation. Allocations must sum to 1. Up to two decimal place precision is supported for IP-based splits and up to three decimal places is supported for cookie-based splits.

Split Shard By

Mechanism used to determine which version a request is sent to when routing configuration for versions within a single service.

Usage

Name
Description

Average Request Retries

The average number of retry requests per unique requests made.

Average Retry Attempts

The average number of retry requests made per unique request that was retried.

Failed Requests

The total number of requests that returned a failure response.

Hostname

The name of the host that this counter is tracking the usage of.

Most Retries

The highest number of retries made for a single request.

Request Timeouts

The total number of requests that timed out waiting for a response.

Requests Retried

The number of unique requests that were retried.

Retry Timeouts

The total number of requests that needed to be retried, but the request retry time exceeded the maximum retry time.

Average Retry Wait (Milliseconds)

The average amount of time retried requests spent waiting.

Maximum Retry Wait (Milliseconds)

The most amount of time a retried request spent waiting.

Minimum Retry Wait (Milliseconds)

The least amount of time a retried request spent waiting.

Status OK Responses

The total number of successful requests that responded with the status OK (200).

Other Status Responses

The total number of successful requests that responded with some other accepted status.

Status Too Many Requests Responses

The total number of successful requests that responded with the status TOO MANY REQUESTS (429).

Successful Requests

The total number of requests that returned a successful response.

Total Requests

The total number of requests made during collection.

Total Retries

The total number of retry requests that were made.

Unique Requests

The number of requests made with unique endpoints.

Version

Name
Description

API Configuration Auth Fail Action

Action to take when users access resources that require authentication. Defaults to redirect.

API Configuration Login

Level of login required to access this resource. Defaults to optional.

API Configuration Script

Path to the script from the application root directory.

API Configuration Security Level

Security (HTTPS) enforcement for this URL.

API Configuration Url

URL to serve the endpoint at.

Automatic Scaling Cool Down Period (Seconds)

Amount of time that the Autoscaler should wait between changes to the number of virtual machines.

Automatic Scaling Cpu Utilization Aggregation Window Length (Seconds)

Period of time over which CPU utilization is calculated.

Automatic Scaling Cpu Utilization Target Utilization

Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.

Automatic Scaling Disk Utilization Target Read Data Rate (Bytes per Second)

Target rate for data read.

Automatic Scaling Disk Utilization Target Read Operations Rate (per Second)

Target rate for read operations.

Automatic Scaling Disk Utilization Target Write Data Rate (Bytes per Second)

Target rate for data written.

Automatic Scaling Disk Utilization Target Write Operations Rate (per Second)

Target rate for write operations.

Automatic Scaling Maximum Concurrent Requests (Requests)

Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.

Automatic Scaling Maximum Idle Instances (Requests)

Maximum number of idle instances that should be maintained for this version.

Automatic Scaling Maximum Pending Latency (Seconds)

Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it.

Automatic Scaling Maximum Total Instances

Maximum number of instances that should be started to handle requests for this version.

Automatic Scaling Minimum Idle Instances

Minimum number of idle instances that should be maintained for this version.

Automatic Scaling Minimum Pending Latency (Seconds)

Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it.

Automatic Scaling Minimum Total Instances

Minimum number of running instances that should be maintained for this version.

Automatic Scaling Network Utilization Target Received Data Rate (Bytes per Second)

Target rate for data received.

Automatic Scaling Network Utilization Target Received Packets Rate (Packets per Second)

Target rate for packets received.

Automatic Scaling Network Utilization Target Sent Data Rate (Bytes per Second)

Target rate for data sent.

Automatic Scaling Network Utilization Target Sent Packets Rate (Packets per Second)

Target rate for packets sent.

Automatic Scaling Request Utilization Target Concurrent Requests (Requests)

Target number of concurrent requests.

Automatic Scaling Request Utilization Target Request Count Rate (Requests per Second)

Target request rate.

Automatic Scaling Standard Scheduler Settings Maximum Instances

Maximum number of instances to run for this version.

Automatic Scaling Standard Scheduler Settings Minimum Instances

Minimum number of instances to run for this version.

Automatic Scaling Standard Scheduler Settings Target Cpu Utilization

Target CPU utilization ratio to maintain when scaling.

Automatic Scaling Standard Scheduler Settings Target Throughput Utilization

Target throughput utilization ratio to maintain when scaling.

Basic Scaling Idle Timeout (Seconds)

Duration of time after the last request that an instance must wait before the instance is shut down.

Basic Scaling Maximum Instances

Maximum number of instances to create for this version.

Beta Settings

Metadata settings that are supplied to this version to enable beta runtime features.

Checks Content Mismatch (%)

Ratio of responses that had content that did not match the check.

Checks Passed (%)

Ratio of checks passed.

CPU Megacycles

CPU usage in megacycles.

CPU Utilization (%)

The amount of allocated CPU in use across an App Engine flexible environment version. Note that some machine types allow bursting above 100%.

Create Time

Time that this version was created. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Created By

Email address of the user who created this version.

Default Expiration (Seconds)

Duration that static files should be cached by web proxies and browsers.

Delta of Serve Style Response

Delta count of responses on the HTTP serve style.

Deployment Cloud Build Options App Yaml Path

Path to the yaml file used in deployment, used to determine runtime configuration details.

Deployment Cloud Build Options Cloud Build Timeout

The Cloud Build timeout used as part of any dependent builds performed by version creation.

Deployment Container Image

URI to the hosted container image in Google Container Registry.

Deployment Zip Files Count

An estimate of the number of files in a zip for a zip deployment.

Deployment Zip Source Url

URL of the zip file to deploy from.

Disk Data Read (Bytes per Second)

Rate of data read from disk across an App Engine flexible environment version.

Disk Data Written (Bytes per Second)

Rate of data written from disk across an App Engine flexible environment version.

Disk Usage

Total size of all the files that are included in this version and currently hosted on the App Engine disk.

Endpoints Api Service Configuration ID

Endpoints service configuration ID as specified by the Service Management API.

Endpoints Api Service Name

Endpoints service name which is the name of the "service" resource in the Service Management API.

Env

App Engine execution environment for this version. Defaults to standard.

Env Variables

Environment variables available to the application.

Health Check Check Interval (Seconds)

Interval between health checks.

Health Check Disable Health Check

Whether to explicitly disable health checks for this instance.

Health Check Healthy Threshold

Number of consecutive successful health checks required before receiving traffic.

Health Check Host

Host header to send when performing an HTTP health check. Example: "myapp.appspot.com"

Health Check Restart Threshold

Number of consecutive failed health checks required before an instance is restarted.

Health Check Timeout (Seconds)

Time before the health check is considered failed.

Health Check Unhealthy Threshold

Number of consecutive failed health checks required before removing traffic.

ID

The version name.

Inbound Services

Before an application can receive email or XMPP messages, the application must be configured to enable the service.

Instance Class

Instance class that is used to run this version. Valid values are: - AutomaticScaling: F1, F2, F4, F4_1G - ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1G - Defaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.

Instance Count

Number of instances that exist.

Interception Count

Delta count of interceptions performed to prevent DoS attacks.

Liveness Check Check Interval (Seconds)

Interval between health checks.

Liveness Check Failure Threshold

Number of consecutive failed checks required before considering the VM unhealthy.

Liveness Check Host

Host header to send when performing a HTTP Liveness check. Example: "myapp.appspot.com"

Liveness Check Initial Delay (Seconds)

The initial delay before starting to execute the checks.

Liveness Check Path

The request path.

Liveness Check Success Threshold

Number of consecutive successful checks required before considering the VM healthy.

Liveness Check Timeout (Seconds)

Time before the check is considered failed.

Manual Scaling Instances

Number of instances to assign to the service at the start.

Memcache Operations

Count of memcache key operations, grouped by command and status.

Memcache Received Data (Bytes)

Amount of data received by app from the memcache API.

Memcache Sent Data (Bytes)

Amount of data sent by app through the memcache API, grouped by memcache command.

Memcache Utilization

Memcache utilization in one hundredth of Memcache Compute Unit.

Memory Usage (Bytes)

Total memory used by running instances.

Module ID

The service/module name.

Network Data Received (Bytes per Second)

Rate of incoming network data across all VMs in an App Engine flexible environment version.

Network Data Sent (Bytes per Second)

Rate of outgoing network data across all VMs in an App Engine flexible environment version.

Network Forwarded Ports

List of ports, or port pairs, to forward from the virtual machine to the application container. Only applicable in the App Engine flexible environment.

Network Instance Tag

Tag to apply to the instance during creation. Only applicable in the App Engine flexible environment.

Network Name

Google Compute Engine network where the virtual machines are created.

Network Subnetwork Name

Google Cloud Platform sub-network where the virtual machines are created.

Nobuild Files Regex

Files that match this pattern will not be built into this version.

Project ID

The identifier of the GCP project associated with this resource.

Quota Denial Count

Delta count of requests that failed due to the app being over quota.

Readiness Check App Start Timeout (Seconds)

A maximum time limit on application initialization, measured from moment the application successfully replies to a healthcheck until it is ready to serve traffic.

Readiness Check Check Interval (Seconds)

Interval between health checks.

Readiness Check Failure Threshold

Number of consecutive failed checks required before removing traffic.

Readiness Check Host

Host header to send when performing a HTTP Readiness check. Example: "myapp.appspot.com"

Readiness Check Path

The request path.

Readiness Check Success Threshold

Number of consecutive successful checks required before receiving traffic.

Readiness Check Timeout (Seconds)

Time before the check is considered failed.

Received Data (Bytes)

Delta count of incoming network bandwidth.

Reserved CPU

Total amount of CPU allocated to an App Engine flexible environment version.

Resources Cpu

CPU needed.

Resources Disk (Gigabits)

Disk size needed.

Resources Memory (Gigabits)

Memory needed.

Response Count

Delta HTTP response count.

Response Latency (Milliseconds)

HTTP response latency.

Runtime

Desired runtime. Example: python27.

Runtime API Version

The version of the API in the given runtime environment.

Runtime Channel

The channel of the runtime to use. Defaults to the default channel.

Sent Data (Bytes)

Delta count of outgoing network bandwidth.

Serving Status

Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.

Threadsafe

Whether multiple requests can be dispatched to this version at once.

Url

Serving URL for this version.

VM

Whether to deploy this version in a container on a virtual machine.

Zones

The Google Compute Engine zones that are supported by this version in the App Engine flexible environment.

Updated 14 days ago

Google Cloud App Engine


Monitor Google Cloud App Engine Web and Compute Hosting Platform

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.