diff --git a/Monitoring/metadata/V3/Alert.php b/Monitoring/metadata/V3/Alert.php index caca7cc0e1b6..8553869e7c2d 100644 Binary files a/Monitoring/metadata/V3/Alert.php and b/Monitoring/metadata/V3/Alert.php differ diff --git a/Monitoring/metadata/V3/Metric.php b/Monitoring/metadata/V3/Metric.php index fe89ba938bb1..c657f16b5ac2 100644 Binary files a/Monitoring/metadata/V3/Metric.php and b/Monitoring/metadata/V3/Metric.php differ diff --git a/Monitoring/metadata/V3/MetricService.php b/Monitoring/metadata/V3/MetricService.php index 5cd56e066aee..22509839efd6 100644 Binary files a/Monitoring/metadata/V3/MetricService.php and b/Monitoring/metadata/V3/MetricService.php differ diff --git a/Monitoring/metadata/V3/QueryService.php b/Monitoring/metadata/V3/QueryService.php index fb4ffd3bc28d..27959d462165 100644 --- a/Monitoring/metadata/V3/QueryService.php +++ b/Monitoring/metadata/V3/QueryService.php @@ -19,10 +19,10 @@ public static function initOnce() { \GPBMetadata\Google\Monitoring\V3\MetricService::initOnce(); $pool->internalAddGeneratedFile( ' -¼ -(google/monitoring/v3/query_service.protogoogle.monitoring.v3google/api/client.proto)google/monitoring/v3/metric_service.proto2Þ - QueryService¡ -QueryTimeSeries,.google.monitoring.v3.QueryTimeSeriesRequest-.google.monitoring.v3.QueryTimeSeriesResponse"1‚Óä“+"&/v3/{name=projects/*}/timeSeries:query:*©ÊAmonitoring.googleapis.comÒA‰https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readBÌ +¿ +(google/monitoring/v3/query_service.protogoogle.monitoring.v3google/api/client.proto)google/monitoring/v3/metric_service.proto2á + QueryService¤ +QueryTimeSeries,.google.monitoring.v3.QueryTimeSeriesRequest-.google.monitoring.v3.QueryTimeSeriesResponse"4ˆ‚Óä“+"&/v3/{name=projects/*}/timeSeries:query:*©ÊAmonitoring.googleapis.comÒA‰https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readBÌ com.google.monitoring.v3BQueryServiceProtoPZAcloud.google.com/go/monitoring/apiv3/v2/monitoringpb;monitoringpbªGoogle.Cloud.Monitoring.V3ÊGoogle\\Cloud\\Monitoring\\V3êGoogle::Cloud::Monitoring::V3bproto3' , true); diff --git a/Monitoring/metadata/V3/Uptime.php b/Monitoring/metadata/V3/Uptime.php index 528518b81c80..a09b147fe5dc 100644 Binary files a/Monitoring/metadata/V3/Uptime.php and b/Monitoring/metadata/V3/Uptime.php differ diff --git a/Monitoring/samples/V3/QueryServiceClient/query_time_series.php b/Monitoring/samples/V3/QueryServiceClient/query_time_series.php index 3f8272a75e9b..9641639edeb1 100644 --- a/Monitoring/samples/V3/QueryServiceClient/query_time_series.php +++ b/Monitoring/samples/V3/QueryServiceClient/query_time_series.php @@ -30,7 +30,10 @@ use Google\Cloud\Monitoring\V3\TimeSeriesData; /** - * Queries time series using Monitoring Query Language. + * Queries time series by using Monitoring Query Language (MQL). We recommend + * using PromQL instead of MQL. For more information about the status of MQL, + * see the [MQL deprecation + * notice](https://cloud.google.com/stackdriver/docs/deprecations/mql). * * @param string $name The * [project](https://cloud.google.com/monitoring/api/v3#project_name) on which diff --git a/Monitoring/samples/V3/UptimeCheckServiceClient/list_uptime_check_ips.php b/Monitoring/samples/V3/UptimeCheckServiceClient/list_uptime_check_ips.php index 21f6ea4d85e7..315df9681d38 100644 --- a/Monitoring/samples/V3/UptimeCheckServiceClient/list_uptime_check_ips.php +++ b/Monitoring/samples/V3/UptimeCheckServiceClient/list_uptime_check_ips.php @@ -30,7 +30,7 @@ use Google\Cloud\Monitoring\V3\UptimeCheckIp; /** - * Returns the list of IP addresses that checkers run from + * Returns the list of IP addresses that checkers run from. * * This sample has been automatically generated and should be regarded as a code * template only. It will require modifications to work: diff --git a/Monitoring/src/V3/AlertPolicy/Condition.php b/Monitoring/src/V3/AlertPolicy/Condition.php index 791ab37cdc38..a19e60428de1 100644 --- a/Monitoring/src/V3/AlertPolicy/Condition.php +++ b/Monitoring/src/V3/AlertPolicy/Condition.php @@ -96,6 +96,8 @@ class Condition extends \Google\Protobuf\Internal\Message * alerts. * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\PrometheusQueryLanguageCondition $condition_prometheus_query_language * A condition that uses the Prometheus query language to define alerts. + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition $condition_sql + * A condition that periodically evaluates a SQL query result. * } */ public function __construct($data = NULL) { @@ -358,6 +360,37 @@ public function setConditionPrometheusQueryLanguage($var) return $this; } + /** + * A condition that periodically evaluates a SQL query result. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition condition_sql = 22; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition|null + */ + public function getConditionSql() + { + return $this->readOneof(22); + } + + public function hasConditionSql() + { + return $this->hasOneof(22); + } + + /** + * A condition that periodically evaluates a SQL query result. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition condition_sql = 22; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition $var + * @return $this + */ + public function setConditionSql($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition::class); + $this->writeOneof(22, $var); + + return $this; + } + /** * @return string */ diff --git a/Monitoring/src/V3/AlertPolicy/Condition/PrometheusQueryLanguageCondition.php b/Monitoring/src/V3/AlertPolicy/Condition/PrometheusQueryLanguageCondition.php index 36ad63e0e6d1..ae9d496b82cd 100644 --- a/Monitoring/src/V3/AlertPolicy/Condition/PrometheusQueryLanguageCondition.php +++ b/Monitoring/src/V3/AlertPolicy/Condition/PrometheusQueryLanguageCondition.php @@ -113,6 +113,18 @@ class PrometheusQueryLanguageCondition extends \Google\Protobuf\Internal\Message * Generated from protobuf field string alert_rule = 6 [(.google.api.field_behavior) = OPTIONAL]; */ private $alert_rule = ''; + /** + * Optional. Whether to disable metric existence validation for this + * condition. + * This allows alerting policies to be defined on metrics that do not yet + * exist, improving advanced customer workflows such as configuring + * alerting policies using Terraform. + * Users with the `monitoring.alertPolicyViewer` role are able to see the + * name of the non-existent metric in the alerting policy condition. + * + * Generated from protobuf field bool disable_metric_validation = 7 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $disable_metric_validation = false; /** * Constructor. @@ -169,6 +181,14 @@ class PrometheusQueryLanguageCondition extends \Google\Protobuf\Internal\Message * [valid Prometheus label * name](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). * This field may not exceed 2048 Unicode characters in length. + * @type bool $disable_metric_validation + * Optional. Whether to disable metric existence validation for this + * condition. + * This allows alerting policies to be defined on metrics that do not yet + * exist, improving advanced customer workflows such as configuring + * alerting policies using Terraform. + * Users with the `monitoring.alertPolicyViewer` role are able to see the + * name of the non-existent metric in the alerting policy condition. * } */ public function __construct($data = NULL) { @@ -426,6 +446,44 @@ public function setAlertRule($var) return $this; } + /** + * Optional. Whether to disable metric existence validation for this + * condition. + * This allows alerting policies to be defined on metrics that do not yet + * exist, improving advanced customer workflows such as configuring + * alerting policies using Terraform. + * Users with the `monitoring.alertPolicyViewer` role are able to see the + * name of the non-existent metric in the alerting policy condition. + * + * Generated from protobuf field bool disable_metric_validation = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool + */ + public function getDisableMetricValidation() + { + return $this->disable_metric_validation; + } + + /** + * Optional. Whether to disable metric existence validation for this + * condition. + * This allows alerting policies to be defined on metrics that do not yet + * exist, improving advanced customer workflows such as configuring + * alerting policies using Terraform. + * Users with the `monitoring.alertPolicyViewer` role are able to see the + * name of the non-existent metric in the alerting policy condition. + * + * Generated from protobuf field bool disable_metric_validation = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var + * @return $this + */ + public function setDisableMetricValidation($var) + { + GPBUtil::checkBool($var); + $this->disable_metric_validation = $var; + + return $this; + } + } // Adding a class alias for backwards compatibility with the previous class name. diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition.php new file mode 100644 index 000000000000..c19251069c82 --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition.php @@ -0,0 +1,303 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition + */ +class SqlCondition extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The Log Analytics SQL query to run, as a string. The query + * must conform to the required shape. Specifically, the query must not + * try to filter the input by time. A filter will automatically be + * applied to filter the input so that the query receives all rows + * received since the last time the query was run. + * For example, the following query extracts all log entries containing an + * HTTP request: + * SELECT + * timestamp, log_name, severity, http_request, resource, labels + * FROM + * my-project.global._Default._AllLogs + * WHERE + * http_request IS NOT NULL + * + * Generated from protobuf field string query = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $query = ''; + protected $schedule; + protected $evaluate; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $query + * Required. The Log Analytics SQL query to run, as a string. The query + * must conform to the required shape. Specifically, the query must not + * try to filter the input by time. A filter will automatically be + * applied to filter the input so that the query receives all rows + * received since the last time the query was run. + * For example, the following query extracts all log entries containing an + * HTTP request: + * SELECT + * timestamp, log_name, severity, http_request, resource, labels + * FROM + * my-project.global._Default._AllLogs + * WHERE + * http_request IS NOT NULL + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Minutes $minutes + * Schedule the query to execute every so many minutes. + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Hourly $hourly + * Schedule the query to execute every so many hours. + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Daily $daily + * Schedule the query to execute every so many days. + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\RowCountTest $row_count_test + * Test the row count against a threshold. + * @type \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\BooleanTest $boolean_test + * Test the boolean value in the indicated column. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. The Log Analytics SQL query to run, as a string. The query + * must conform to the required shape. Specifically, the query must not + * try to filter the input by time. A filter will automatically be + * applied to filter the input so that the query receives all rows + * received since the last time the query was run. + * For example, the following query extracts all log entries containing an + * HTTP request: + * SELECT + * timestamp, log_name, severity, http_request, resource, labels + * FROM + * my-project.global._Default._AllLogs + * WHERE + * http_request IS NOT NULL + * + * Generated from protobuf field string query = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getQuery() + { + return $this->query; + } + + /** + * Required. The Log Analytics SQL query to run, as a string. The query + * must conform to the required shape. Specifically, the query must not + * try to filter the input by time. A filter will automatically be + * applied to filter the input so that the query receives all rows + * received since the last time the query was run. + * For example, the following query extracts all log entries containing an + * HTTP request: + * SELECT + * timestamp, log_name, severity, http_request, resource, labels + * FROM + * my-project.global._Default._AllLogs + * WHERE + * http_request IS NOT NULL + * + * Generated from protobuf field string query = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setQuery($var) + { + GPBUtil::checkString($var, True); + $this->query = $var; + + return $this; + } + + /** + * Schedule the query to execute every so many minutes. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Minutes minutes = 2; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Minutes|null + */ + public function getMinutes() + { + return $this->readOneof(2); + } + + public function hasMinutes() + { + return $this->hasOneof(2); + } + + /** + * Schedule the query to execute every so many minutes. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Minutes minutes = 2; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Minutes $var + * @return $this + */ + public function setMinutes($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Minutes::class); + $this->writeOneof(2, $var); + + return $this; + } + + /** + * Schedule the query to execute every so many hours. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Hourly hourly = 3; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Hourly|null + */ + public function getHourly() + { + return $this->readOneof(3); + } + + public function hasHourly() + { + return $this->hasOneof(3); + } + + /** + * Schedule the query to execute every so many hours. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Hourly hourly = 3; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Hourly $var + * @return $this + */ + public function setHourly($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Hourly::class); + $this->writeOneof(3, $var); + + return $this; + } + + /** + * Schedule the query to execute every so many days. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Daily daily = 4; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Daily|null + */ + public function getDaily() + { + return $this->readOneof(4); + } + + public function hasDaily() + { + return $this->hasOneof(4); + } + + /** + * Schedule the query to execute every so many days. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Daily daily = 4; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Daily $var + * @return $this + */ + public function setDaily($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\Daily::class); + $this->writeOneof(4, $var); + + return $this; + } + + /** + * Test the row count against a threshold. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.RowCountTest row_count_test = 5; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\RowCountTest|null + */ + public function getRowCountTest() + { + return $this->readOneof(5); + } + + public function hasRowCountTest() + { + return $this->hasOneof(5); + } + + /** + * Test the row count against a threshold. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.RowCountTest row_count_test = 5; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\RowCountTest $var + * @return $this + */ + public function setRowCountTest($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\RowCountTest::class); + $this->writeOneof(5, $var); + + return $this; + } + + /** + * Test the boolean value in the indicated column. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.BooleanTest boolean_test = 6; + * @return \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\BooleanTest|null + */ + public function getBooleanTest() + { + return $this->readOneof(6); + } + + public function hasBooleanTest() + { + return $this->hasOneof(6); + } + + /** + * Test the boolean value in the indicated column. + * + * Generated from protobuf field .google.monitoring.v3.AlertPolicy.Condition.SqlCondition.BooleanTest boolean_test = 6; + * @param \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\BooleanTest $var + * @return $this + */ + public function setBooleanTest($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Monitoring\V3\AlertPolicy\Condition\SqlCondition\BooleanTest::class); + $this->writeOneof(6, $var); + + return $this; + } + + /** + * @return string + */ + public function getSchedule() + { + return $this->whichOneof("schedule"); + } + + /** + * @return string + */ + public function getEvaluate() + { + return $this->whichOneof("evaluate"); + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(SqlCondition::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition::class); + diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/BooleanTest.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/BooleanTest.php new file mode 100644 index 000000000000..8299c1a5230d --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/BooleanTest.php @@ -0,0 +1,75 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition.BooleanTest + */ +class BooleanTest extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The name of the column containing the boolean value. If the + * value in a row is NULL, that row is ignored. + * + * Generated from protobuf field string column = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $column = ''; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type string $column + * Required. The name of the column containing the boolean value. If the + * value in a row is NULL, that row is ignored. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. The name of the column containing the boolean value. If the + * value in a row is NULL, that row is ignored. + * + * Generated from protobuf field string column = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return string + */ + public function getColumn() + { + return $this->column; + } + + /** + * Required. The name of the column containing the boolean value. If the + * value in a row is NULL, that row is ignored. + * + * Generated from protobuf field string column = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param string $var + * @return $this + */ + public function setColumn($var) + { + GPBUtil::checkString($var, True); + $this->column = $var; + + return $this; + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(BooleanTest::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition_BooleanTest::class); + diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Daily.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Daily.php new file mode 100644 index 000000000000..9814dd4a633b --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Daily.php @@ -0,0 +1,126 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Daily + */ +class Daily extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The number of days between runs. Must be greater than or + * equal to 1 day and less than or equal to 31 days. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $periodicity = 0; + /** + * Optional. The time of day (in UTC) at which the query should run. If + * left unspecified, the server picks an arbitrary time of day and runs + * the query at the same time each day. + * + * Generated from protobuf field .google.type.TimeOfDay execution_time = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $execution_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $periodicity + * Required. The number of days between runs. Must be greater than or + * equal to 1 day and less than or equal to 31 days. + * @type \Google\Type\TimeOfDay $execution_time + * Optional. The time of day (in UTC) at which the query should run. If + * left unspecified, the server picks an arbitrary time of day and runs + * the query at the same time each day. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. The number of days between runs. Must be greater than or + * equal to 1 day and less than or equal to 31 days. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return int + */ + public function getPeriodicity() + { + return $this->periodicity; + } + + /** + * Required. The number of days between runs. Must be greater than or + * equal to 1 day and less than or equal to 31 days. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param int $var + * @return $this + */ + public function setPeriodicity($var) + { + GPBUtil::checkInt32($var); + $this->periodicity = $var; + + return $this; + } + + /** + * Optional. The time of day (in UTC) at which the query should run. If + * left unspecified, the server picks an arbitrary time of day and runs + * the query at the same time each day. + * + * Generated from protobuf field .google.type.TimeOfDay execution_time = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Type\TimeOfDay|null + */ + public function getExecutionTime() + { + return $this->execution_time; + } + + public function hasExecutionTime() + { + return isset($this->execution_time); + } + + public function clearExecutionTime() + { + unset($this->execution_time); + } + + /** + * Optional. The time of day (in UTC) at which the query should run. If + * left unspecified, the server picks an arbitrary time of day and runs + * the query at the same time each day. + * + * Generated from protobuf field .google.type.TimeOfDay execution_time = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Type\TimeOfDay $var + * @return $this + */ + public function setExecutionTime($var) + { + GPBUtil::checkMessage($var, \Google\Type\TimeOfDay::class); + $this->execution_time = $var; + + return $this; + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(Daily::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition_Daily::class); + diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Hourly.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Hourly.php new file mode 100644 index 000000000000..1f7f093d5329 --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Hourly.php @@ -0,0 +1,130 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Hourly + */ +class Hourly extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The number of hours between runs. Must be greater than or + * equal to 1 hour and less than or equal to 48 hours. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $periodicity = 0; + /** + * Optional. The number of minutes after the hour (in UTC) to run the + * query. Must be greater than or equal to 0 minutes and less than or + * equal to 59 minutes. If left unspecified, then an arbitrary offset + * is used. + * + * Generated from protobuf field optional int32 minute_offset = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $minute_offset = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $periodicity + * Required. The number of hours between runs. Must be greater than or + * equal to 1 hour and less than or equal to 48 hours. + * @type int $minute_offset + * Optional. The number of minutes after the hour (in UTC) to run the + * query. Must be greater than or equal to 0 minutes and less than or + * equal to 59 minutes. If left unspecified, then an arbitrary offset + * is used. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. The number of hours between runs. Must be greater than or + * equal to 1 hour and less than or equal to 48 hours. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return int + */ + public function getPeriodicity() + { + return $this->periodicity; + } + + /** + * Required. The number of hours between runs. Must be greater than or + * equal to 1 hour and less than or equal to 48 hours. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param int $var + * @return $this + */ + public function setPeriodicity($var) + { + GPBUtil::checkInt32($var); + $this->periodicity = $var; + + return $this; + } + + /** + * Optional. The number of minutes after the hour (in UTC) to run the + * query. Must be greater than or equal to 0 minutes and less than or + * equal to 59 minutes. If left unspecified, then an arbitrary offset + * is used. + * + * Generated from protobuf field optional int32 minute_offset = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return int + */ + public function getMinuteOffset() + { + return isset($this->minute_offset) ? $this->minute_offset : 0; + } + + public function hasMinuteOffset() + { + return isset($this->minute_offset); + } + + public function clearMinuteOffset() + { + unset($this->minute_offset); + } + + /** + * Optional. The number of minutes after the hour (in UTC) to run the + * query. Must be greater than or equal to 0 minutes and less than or + * equal to 59 minutes. If left unspecified, then an arbitrary offset + * is used. + * + * Generated from protobuf field optional int32 minute_offset = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var + * @return $this + */ + public function setMinuteOffset($var) + { + GPBUtil::checkInt32($var); + $this->minute_offset = $var; + + return $this; + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(Hourly::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition_Hourly::class); + diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Minutes.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Minutes.php new file mode 100644 index 000000000000..54c8466939a2 --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/Minutes.php @@ -0,0 +1,78 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition.Minutes + */ +class Minutes extends \Google\Protobuf\Internal\Message +{ + /** + * Required. Number of minutes between runs. The interval must be + * greater than or equal to 5 minutes and less than or equal to 1440 + * minutes. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $periodicity = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $periodicity + * Required. Number of minutes between runs. The interval must be + * greater than or equal to 5 minutes and less than or equal to 1440 + * minutes. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. Number of minutes between runs. The interval must be + * greater than or equal to 5 minutes and less than or equal to 1440 + * minutes. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return int + */ + public function getPeriodicity() + { + return $this->periodicity; + } + + /** + * Required. Number of minutes between runs. The interval must be + * greater than or equal to 5 minutes and less than or equal to 1440 + * minutes. + * + * Generated from protobuf field int32 periodicity = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param int $var + * @return $this + */ + public function setPeriodicity($var) + { + GPBUtil::checkInt32($var); + $this->periodicity = $var; + + return $this; + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(Minutes::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition_Minutes::class); + diff --git a/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/RowCountTest.php b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/RowCountTest.php new file mode 100644 index 000000000000..58d0f88df4d4 --- /dev/null +++ b/Monitoring/src/V3/AlertPolicy/Condition/SqlCondition/RowCountTest.php @@ -0,0 +1,109 @@ +google.monitoring.v3.AlertPolicy.Condition.SqlCondition.RowCountTest + */ +class RowCountTest extends \Google\Protobuf\Internal\Message +{ + /** + * Required. The comparison to apply between the number of rows returned + * by the query and the threshold. + * + * Generated from protobuf field .google.monitoring.v3.ComparisonType comparison = 1 [(.google.api.field_behavior) = REQUIRED]; + */ + private $comparison = 0; + /** + * Required. The value against which to compare the row count. + * + * Generated from protobuf field int64 threshold = 2 [(.google.api.field_behavior) = REQUIRED]; + */ + private $threshold = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int $comparison + * Required. The comparison to apply between the number of rows returned + * by the query and the threshold. + * @type int|string $threshold + * Required. The value against which to compare the row count. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Monitoring\V3\Alert::initOnce(); + parent::__construct($data); + } + + /** + * Required. The comparison to apply between the number of rows returned + * by the query and the threshold. + * + * Generated from protobuf field .google.monitoring.v3.ComparisonType comparison = 1 [(.google.api.field_behavior) = REQUIRED]; + * @return int + */ + public function getComparison() + { + return $this->comparison; + } + + /** + * Required. The comparison to apply between the number of rows returned + * by the query and the threshold. + * + * Generated from protobuf field .google.monitoring.v3.ComparisonType comparison = 1 [(.google.api.field_behavior) = REQUIRED]; + * @param int $var + * @return $this + */ + public function setComparison($var) + { + GPBUtil::checkEnum($var, \Google\Cloud\Monitoring\V3\ComparisonType::class); + $this->comparison = $var; + + return $this; + } + + /** + * Required. The value against which to compare the row count. + * + * Generated from protobuf field int64 threshold = 2 [(.google.api.field_behavior) = REQUIRED]; + * @return int|string + */ + public function getThreshold() + { + return $this->threshold; + } + + /** + * Required. The value against which to compare the row count. + * + * Generated from protobuf field int64 threshold = 2 [(.google.api.field_behavior) = REQUIRED]; + * @param int|string $var + * @return $this + */ + public function setThreshold($var) + { + GPBUtil::checkInt64($var); + $this->threshold = $var; + + return $this; + } + +} + +// Adding a class alias for backwards compatibility with the previous class name. +class_alias(RowCountTest::class, \Google\Cloud\Monitoring\V3\AlertPolicy_Condition_SqlCondition_RowCountTest::class); + diff --git a/Monitoring/src/V3/Client/QueryServiceClient.php b/Monitoring/src/V3/Client/QueryServiceClient.php index d56bf0ede01b..b8b8d2daeda4 100644 --- a/Monitoring/src/V3/Client/QueryServiceClient.php +++ b/Monitoring/src/V3/Client/QueryServiceClient.php @@ -170,7 +170,10 @@ public function __call($method, $args) } /** - * Queries time series using Monitoring Query Language. + * Queries time series by using Monitoring Query Language (MQL). We recommend + * using PromQL instead of MQL. For more information about the status of MQL, + * see the [MQL deprecation + * notice](https://cloud.google.com/stackdriver/docs/deprecations/mql). * * The async variant is {@see QueryServiceClient::queryTimeSeriesAsync()} . * @@ -189,6 +192,8 @@ public function __call($method, $args) * @return PagedListResponse * * @throws ApiException Thrown if the API call fails. + * + * @deprecated This method will be removed in the next major version update. */ public function queryTimeSeries(QueryTimeSeriesRequest $request, array $callOptions = []): PagedListResponse { diff --git a/Monitoring/src/V3/Client/UptimeCheckServiceClient.php b/Monitoring/src/V3/Client/UptimeCheckServiceClient.php index d6dd0ab10973..4b8d424c98cb 100644 --- a/Monitoring/src/V3/Client/UptimeCheckServiceClient.php +++ b/Monitoring/src/V3/Client/UptimeCheckServiceClient.php @@ -417,7 +417,7 @@ public function listUptimeCheckConfigs(ListUptimeCheckConfigsRequest $request, a } /** - * Returns the list of IP addresses that checkers run from + * Returns the list of IP addresses that checkers run from. * * The async variant is {@see UptimeCheckServiceClient::listUptimeCheckIpsAsync()} * . diff --git a/Monitoring/src/V3/Gapic/MetricServiceGapicClient.php b/Monitoring/src/V3/Gapic/MetricServiceGapicClient.php index 00bf31992651..38b412a830e1 100644 --- a/Monitoring/src/V3/Gapic/MetricServiceGapicClient.php +++ b/Monitoring/src/V3/Gapic/MetricServiceGapicClient.php @@ -926,7 +926,7 @@ public function getMonitoredResourceDescriptor($name, array $optionalArgs = []) * Optional. * * @type string $filter - * If this field is empty, all custom and + * Optional. If this field is empty, all custom and * system-defined metric descriptors are returned. * Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters) * specifies which metric descriptors are to be diff --git a/Monitoring/src/V3/Gapic/QueryServiceGapicClient.php b/Monitoring/src/V3/Gapic/QueryServiceGapicClient.php index cd386575a623..ff0ee708271c 100644 --- a/Monitoring/src/V3/Gapic/QueryServiceGapicClient.php +++ b/Monitoring/src/V3/Gapic/QueryServiceGapicClient.php @@ -178,7 +178,10 @@ public function __construct(array $options = []) } /** - * Queries time series using Monitoring Query Language. + * Queries time series by using Monitoring Query Language (MQL). We recommend + * using PromQL instead of MQL. For more information about the status of MQL, + * see the [MQL deprecation + * notice](https://cloud.google.com/stackdriver/docs/deprecations/mql). * * Sample code: * ``` @@ -233,6 +236,8 @@ public function __construct(array $options = []) * @return \Google\ApiCore\PagedListResponse * * @throws ApiException if the remote call fails + * + * @deprecated This method will be removed in the next major version update. */ public function queryTimeSeries($name, $query, array $optionalArgs = []) { diff --git a/Monitoring/src/V3/Gapic/UptimeCheckServiceGapicClient.php b/Monitoring/src/V3/Gapic/UptimeCheckServiceGapicClient.php index 88d26a215cac..d9a240f71ff0 100644 --- a/Monitoring/src/V3/Gapic/UptimeCheckServiceGapicClient.php +++ b/Monitoring/src/V3/Gapic/UptimeCheckServiceGapicClient.php @@ -601,7 +601,7 @@ public function listUptimeCheckConfigs($parent, array $optionalArgs = []) } /** - * Returns the list of IP addresses that checkers run from + * Returns the list of IP addresses that checkers run from. * * Sample code: * ``` diff --git a/Monitoring/src/V3/ListMetricDescriptorsRequest.php b/Monitoring/src/V3/ListMetricDescriptorsRequest.php index 50cd5a457517..56021794606b 100644 --- a/Monitoring/src/V3/ListMetricDescriptorsRequest.php +++ b/Monitoring/src/V3/ListMetricDescriptorsRequest.php @@ -25,7 +25,7 @@ class ListMetricDescriptorsRequest extends \Google\Protobuf\Internal\Message */ private $name = ''; /** - * If this field is empty, all custom and + * Optional. If this field is empty, all custom and * system-defined metric descriptors are returned. * Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters) * specifies which metric descriptors are to be @@ -33,23 +33,24 @@ class ListMetricDescriptorsRequest extends \Google\Protobuf\Internal\Message * [custom metrics](https://cloud.google.com/monitoring/custom-metrics): * metric.type = starts_with("custom.googleapis.com/") * - * Generated from protobuf field string filter = 2; + * Generated from protobuf field string filter = 2 [(.google.api.field_behavior) = OPTIONAL]; */ private $filter = ''; /** - * A positive number that is the maximum number of results to return. The - * default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is - * submitted, will instead return a maximum of 10,000 results. + * Optional. A positive number that is the maximum number of results to + * return. The default and maximum value is 10,000. If a page_size <= 0 or > + * 10,000 is submitted, will instead return a maximum of 10,000 results. * - * Generated from protobuf field int32 page_size = 3; + * Generated from protobuf field int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL]; */ private $page_size = 0; /** - * If this field is not empty then it must contain the `nextPageToken` value - * returned by a previous call to this method. Using this field causes the - * method to return additional results from the previous method call. + * Optional. If this field is not empty then it must contain the + * `nextPageToken` value returned by a previous call to this method. Using + * this field causes the method to return additional results from the previous + * method call. * - * Generated from protobuf field string page_token = 4; + * Generated from protobuf field string page_token = 4 [(.google.api.field_behavior) = OPTIONAL]; */ private $page_token = ''; @@ -82,7 +83,7 @@ public static function build(string $name): self * to execute the request. The format is: * projects/[PROJECT_ID_OR_NUMBER] * @type string $filter - * If this field is empty, all custom and + * Optional. If this field is empty, all custom and * system-defined metric descriptors are returned. * Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters) * specifies which metric descriptors are to be @@ -90,13 +91,14 @@ public static function build(string $name): self * [custom metrics](https://cloud.google.com/monitoring/custom-metrics): * metric.type = starts_with("custom.googleapis.com/") * @type int $page_size - * A positive number that is the maximum number of results to return. The - * default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is - * submitted, will instead return a maximum of 10,000 results. + * Optional. A positive number that is the maximum number of results to + * return. The default and maximum value is 10,000. If a page_size <= 0 or > + * 10,000 is submitted, will instead return a maximum of 10,000 results. * @type string $page_token - * If this field is not empty then it must contain the `nextPageToken` value - * returned by a previous call to this method. Using this field causes the - * method to return additional results from the previous method call. + * Optional. If this field is not empty then it must contain the + * `nextPageToken` value returned by a previous call to this method. Using + * this field causes the method to return additional results from the previous + * method call. * } */ public function __construct($data = NULL) { @@ -137,7 +139,7 @@ public function setName($var) } /** - * If this field is empty, all custom and + * Optional. If this field is empty, all custom and * system-defined metric descriptors are returned. * Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters) * specifies which metric descriptors are to be @@ -145,7 +147,7 @@ public function setName($var) * [custom metrics](https://cloud.google.com/monitoring/custom-metrics): * metric.type = starts_with("custom.googleapis.com/") * - * Generated from protobuf field string filter = 2; + * Generated from protobuf field string filter = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return string */ public function getFilter() @@ -154,7 +156,7 @@ public function getFilter() } /** - * If this field is empty, all custom and + * Optional. If this field is empty, all custom and * system-defined metric descriptors are returned. * Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters) * specifies which metric descriptors are to be @@ -162,7 +164,7 @@ public function getFilter() * [custom metrics](https://cloud.google.com/monitoring/custom-metrics): * metric.type = starts_with("custom.googleapis.com/") * - * Generated from protobuf field string filter = 2; + * Generated from protobuf field string filter = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var * @return $this */ @@ -175,11 +177,11 @@ public function setFilter($var) } /** - * A positive number that is the maximum number of results to return. The - * default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is - * submitted, will instead return a maximum of 10,000 results. + * Optional. A positive number that is the maximum number of results to + * return. The default and maximum value is 10,000. If a page_size <= 0 or > + * 10,000 is submitted, will instead return a maximum of 10,000 results. * - * Generated from protobuf field int32 page_size = 3; + * Generated from protobuf field int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return int */ public function getPageSize() @@ -188,11 +190,11 @@ public function getPageSize() } /** - * A positive number that is the maximum number of results to return. The - * default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is - * submitted, will instead return a maximum of 10,000 results. + * Optional. A positive number that is the maximum number of results to + * return. The default and maximum value is 10,000. If a page_size <= 0 or > + * 10,000 is submitted, will instead return a maximum of 10,000 results. * - * Generated from protobuf field int32 page_size = 3; + * Generated from protobuf field int32 page_size = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var * @return $this */ @@ -205,11 +207,12 @@ public function setPageSize($var) } /** - * If this field is not empty then it must contain the `nextPageToken` value - * returned by a previous call to this method. Using this field causes the - * method to return additional results from the previous method call. + * Optional. If this field is not empty then it must contain the + * `nextPageToken` value returned by a previous call to this method. Using + * this field causes the method to return additional results from the previous + * method call. * - * Generated from protobuf field string page_token = 4; + * Generated from protobuf field string page_token = 4 [(.google.api.field_behavior) = OPTIONAL]; * @return string */ public function getPageToken() @@ -218,11 +221,12 @@ public function getPageToken() } /** - * If this field is not empty then it must contain the `nextPageToken` value - * returned by a previous call to this method. Using this field causes the - * method to return additional results from the previous method call. + * Optional. If this field is not empty then it must contain the + * `nextPageToken` value returned by a previous call to this method. Using + * this field causes the method to return additional results from the previous + * method call. * - * Generated from protobuf field string page_token = 4; + * Generated from protobuf field string page_token = 4 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var * @return $this */ diff --git a/Monitoring/src/V3/QueryTimeSeriesRequest.php b/Monitoring/src/V3/QueryTimeSeriesRequest.php index 1c2545b7a036..1e22730cb714 100644 --- a/Monitoring/src/V3/QueryTimeSeriesRequest.php +++ b/Monitoring/src/V3/QueryTimeSeriesRequest.php @@ -9,8 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The `QueryTimeSeries` request. + * The `QueryTimeSeries` request. For information about the status of + * Monitoring Query Language (MQL), see the [MQL deprecation + * notice](https://cloud.google.com/stackdriver/docs/deprecations/mql). * + * @deprecated * Generated from protobuf message google.monitoring.v3.QueryTimeSeriesRequest */ class QueryTimeSeriesRequest extends \Google\Protobuf\Internal\Message diff --git a/Monitoring/src/V3/QueryTimeSeriesResponse.php b/Monitoring/src/V3/QueryTimeSeriesResponse.php index fda2b89f1f31..8c54238c559e 100644 --- a/Monitoring/src/V3/QueryTimeSeriesResponse.php +++ b/Monitoring/src/V3/QueryTimeSeriesResponse.php @@ -9,8 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The `QueryTimeSeries` response. + * The `QueryTimeSeries` response. For information about the status of + * Monitoring Query Language (MQL), see the [MQL deprecation + * notice](https://cloud.google.com/stackdriver/docs/deprecations/mql). * + * @deprecated * Generated from protobuf message google.monitoring.v3.QueryTimeSeriesResponse */ class QueryTimeSeriesResponse extends \Google\Protobuf\Internal\Message diff --git a/Monitoring/src/V3/ServiceLevelObjective.php b/Monitoring/src/V3/ServiceLevelObjective.php index 30c09f3bd178..3dd7b1282915 100644 --- a/Monitoring/src/V3/ServiceLevelObjective.php +++ b/Monitoring/src/V3/ServiceLevelObjective.php @@ -43,7 +43,7 @@ class ServiceLevelObjective extends \Google\Protobuf\Internal\Message private $service_level_indicator = null; /** * The fraction of service that must be good in order for this objective to be - * met. `0 < goal <= 0.999`. + * met. `0 < goal <= 0.9999`. * * Generated from protobuf field double goal = 4; */ @@ -78,7 +78,7 @@ class ServiceLevelObjective extends \Google\Protobuf\Internal\Message * quality. * @type float $goal * The fraction of service that must be good in order for this objective to be - * met. `0 < goal <= 0.999`. + * met. `0 < goal <= 0.9999`. * @type \Google\Protobuf\Duration $rolling_period * A rolling time period, semantically "in the past ``". * Must be an integer multiple of 1 day no larger than 30 days. @@ -196,7 +196,7 @@ public function setServiceLevelIndicator($var) /** * The fraction of service that must be good in order for this objective to be - * met. `0 < goal <= 0.999`. + * met. `0 < goal <= 0.9999`. * * Generated from protobuf field double goal = 4; * @return float @@ -208,7 +208,7 @@ public function getGoal() /** * The fraction of service that must be good in order for this objective to be - * met. `0 < goal <= 0.999`. + * met. `0 < goal <= 0.9999`. * * Generated from protobuf field double goal = 4; * @param float $var diff --git a/Monitoring/src/V3/TimeSeries.php b/Monitoring/src/V3/TimeSeries.php index 3a07f67b531c..939e92bd25ea 100644 --- a/Monitoring/src/V3/TimeSeries.php +++ b/Monitoring/src/V3/TimeSeries.php @@ -80,11 +80,21 @@ class TimeSeries extends \Google\Protobuf\Internal\Message /** * The units in which the metric value is reported. It is only applicable * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` - * defines the representation of the stored metric values. + * defines the representation of the stored metric values. This field can only + * be changed through CreateTimeSeries when it is empty. * * Generated from protobuf field string unit = 8; */ private $unit = ''; + /** + * Input only. A detailed description of the time series that will be + * associated with the + * [google.api.MetricDescriptor][google.api.MetricDescriptor] for the metric. + * Once set, this field cannot be changed through CreateTimeSeries. + * + * Generated from protobuf field string description = 9; + */ + private $description = ''; /** * Constructor. @@ -130,7 +140,13 @@ class TimeSeries extends \Google\Protobuf\Internal\Message * @type string $unit * The units in which the metric value is reported. It is only applicable * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` - * defines the representation of the stored metric values. + * defines the representation of the stored metric values. This field can only + * be changed through CreateTimeSeries when it is empty. + * @type string $description + * Input only. A detailed description of the time series that will be + * associated with the + * [google.api.MetricDescriptor][google.api.MetricDescriptor] for the metric. + * Once set, this field cannot be changed through CreateTimeSeries. * } */ public function __construct($data = NULL) { @@ -373,7 +389,8 @@ public function setPoints($var) /** * The units in which the metric value is reported. It is only applicable * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` - * defines the representation of the stored metric values. + * defines the representation of the stored metric values. This field can only + * be changed through CreateTimeSeries when it is empty. * * Generated from protobuf field string unit = 8; * @return string @@ -386,7 +403,8 @@ public function getUnit() /** * The units in which the metric value is reported. It is only applicable * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` - * defines the representation of the stored metric values. + * defines the representation of the stored metric values. This field can only + * be changed through CreateTimeSeries when it is empty. * * Generated from protobuf field string unit = 8; * @param string $var @@ -400,5 +418,37 @@ public function setUnit($var) return $this; } + /** + * Input only. A detailed description of the time series that will be + * associated with the + * [google.api.MetricDescriptor][google.api.MetricDescriptor] for the metric. + * Once set, this field cannot be changed through CreateTimeSeries. + * + * Generated from protobuf field string description = 9; + * @return string + */ + public function getDescription() + { + return $this->description; + } + + /** + * Input only. A detailed description of the time series that will be + * associated with the + * [google.api.MetricDescriptor][google.api.MetricDescriptor] for the metric. + * Once set, this field cannot be changed through CreateTimeSeries. + * + * Generated from protobuf field string description = 9; + * @param string $var + * @return $this + */ + public function setDescription($var) + { + GPBUtil::checkString($var, True); + $this->description = $var; + + return $this; + } + } diff --git a/Monitoring/src/V3/UptimeCheckConfig/HttpCheck/ServiceAgentAuthentication.php b/Monitoring/src/V3/UptimeCheckConfig/HttpCheck/ServiceAgentAuthentication.php index 2dfc502b4bbb..a3b2d6a7e776 100644 --- a/Monitoring/src/V3/UptimeCheckConfig/HttpCheck/ServiceAgentAuthentication.php +++ b/Monitoring/src/V3/UptimeCheckConfig/HttpCheck/ServiceAgentAuthentication.php @@ -9,10 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Contains information needed for generating an + * Contains information needed for generating either an * [OpenID Connect - * token](https://developers.google.com/identity/protocols/OpenIDConnect). - * The OIDC token will be generated for the Monitoring service agent service + * token](https://developers.google.com/identity/protocols/OpenIDConnect) or + * [OAuth token](https://developers.google.com/identity/protocols/oauth2). + * The token will be generated for the Monitoring service agent service * account. * * Generated from protobuf message google.monitoring.v3.UptimeCheckConfig.HttpCheck.ServiceAgentAuthentication