MetricDescriptor
class MetricDescriptor extends Message
Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.
Generated from protobuf message google.api.MetricDescriptor
Methods
Constructor.
The resource name of the metric descriptor.
The resource name of the metric descriptor.
The metric type, including its DNS name prefix. The type is not
URL-encoded. All user-defined custom metric types have the DNS name
custom.googleapis.com
. Metric types should use a natural hierarchical
grouping. For example:
"custom.googleapis.com/invoice/paid/amount"
"appengine.googleapis.com/http/server/response_latencies"
The metric type, including its DNS name prefix. The type is not
URL-encoded. All user-defined custom metric types have the DNS name
custom.googleapis.com
. Metric types should use a natural hierarchical
grouping. For example:
"custom.googleapis.com/invoice/paid/amount"
"appengine.googleapis.com/http/server/response_latencies"
The set of labels that can be used to describe a specific
instance of this metric type. For example, the
appengine.googleapis.com/http/server/response_latencies
metric
type has a label for the HTTP response code, response_code
, so
you can look at latencies for successful responses or just
for responses that failed.
The set of labels that can be used to describe a specific
instance of this metric type. For example, the
appengine.googleapis.com/http/server/response_latencies
metric
type has a label for the HTTP response code, response_code
, so
you can look at latencies for successful responses or just
for responses that failed.
Whether the metric records instantaneous values, changes to a value, etc.
Whether the metric records instantaneous values, changes to a value, etc.
Whether the measurement is an integer, a floating-point number, etc.
Whether the measurement is an integer, a floating-point number, etc.
The unit in which the metric value is reported. It is only applicable
if the value_type
is INT64
, DOUBLE
, or DISTRIBUTION
. The
supported units are a subset of The Unified Code for Units of
Measure standard:
Basic units (UNIT)
* bit
bit
* By
byte
* s
second
* min
minute
* h
hour
* d
day
Prefixes (PREFIX)
* k
kilo (103)
* M
mega (106)
* G
giga (109)
* T
tera (1012)
* P
peta (1015)
* E
exa (1018)
* Z
zetta (1021)
* Y
yotta (1024)
* m
milli (10-3)
* u
micro (10-6)
* n
nano (10-9)
* p
pico (10-12)
* f
femto (10-15)
* a
atto (10-18)
* z
zepto (10-21)
* y
yocto (10-24)
* Ki
kibi (210)
* Mi
mebi (220)
* Gi
gibi (230)
* Ti
tebi (240)
Grammar
The grammar also includes these connectors:
* /
division (as an infix operator, e.g. 1/s
).
The unit in which the metric value is reported. It is only applicable
if the value_type
is INT64
, DOUBLE
, or DISTRIBUTION
. The
supported units are a subset of The Unified Code for Units of
Measure standard:
Basic units (UNIT)
* bit
bit
* By
byte
* s
second
* min
minute
* h
hour
* d
day
Prefixes (PREFIX)
* k
kilo (103)
* M
mega (106)
* G
giga (109)
* T
tera (1012)
* P
peta (1015)
* E
exa (1018)
* Z
zetta (1021)
* Y
yotta (1024)
* m
milli (10-3)
* u
micro (10-6)
* n
nano (10-9)
* p
pico (10-12)
* f
femto (10-15)
* a
atto (10-18)
* z
zepto (10-21)
* y
yocto (10-24)
* Ki
kibi (210)
* Mi
mebi (220)
* Gi
gibi (230)
* Ti
tebi (240)
Grammar
The grammar also includes these connectors:
* /
division (as an infix operator, e.g. 1/s
).
A detailed description of the metric, which can be used in documentation.
A detailed description of the metric, which can be used in documentation.
A concise name for the metric, which can be displayed in user interfaces.
A concise name for the metric, which can be displayed in user interfaces.
Details
at line 225
__construct(array $data = NULL)
Constructor.
at line 236
string
getName()
The resource name of the metric descriptor.
Generated from protobuf field string name = 1;
at line 248
$this
setName(string $var)
The resource name of the metric descriptor.
Generated from protobuf field string name = 1;
at line 267
string
getType()
The metric type, including its DNS name prefix. The type is not
URL-encoded. All user-defined custom metric types have the DNS name
custom.googleapis.com
. Metric types should use a natural hierarchical
grouping. For example:
"custom.googleapis.com/invoice/paid/amount"
"appengine.googleapis.com/http/server/response_latencies"
Generated from protobuf field string type = 8;
at line 284
$this
setType(string $var)
The metric type, including its DNS name prefix. The type is not
URL-encoded. All user-defined custom metric types have the DNS name
custom.googleapis.com
. Metric types should use a natural hierarchical
grouping. For example:
"custom.googleapis.com/invoice/paid/amount"
"appengine.googleapis.com/http/server/response_latencies"
Generated from protobuf field string type = 8;
at line 303
RepeatedField
getLabels()
The set of labels that can be used to describe a specific
instance of this metric type. For example, the
appengine.googleapis.com/http/server/response_latencies
metric
type has a label for the HTTP response code, response_code
, so
you can look at latencies for successful responses or just
for responses that failed.
Generated from protobuf field repeated .google.api.LabelDescriptor labels = 2;
at line 320
$this
setLabels(LabelDescriptor[]|RepeatedField $var)
The set of labels that can be used to describe a specific
instance of this metric type. For example, the
appengine.googleapis.com/http/server/response_latencies
metric
type has a label for the HTTP response code, response_code
, so
you can look at latencies for successful responses or just
for responses that failed.
Generated from protobuf field repeated .google.api.LabelDescriptor labels = 2;
at line 335
int
getMetricKind()
Whether the metric records instantaneous values, changes to a value, etc.
Some combinations of metric_kind
and value_type
might not be supported.
Generated from protobuf field .google.api.MetricDescriptor.MetricKind metric_kind = 3;
at line 348
$this
setMetricKind(int $var)
Whether the metric records instantaneous values, changes to a value, etc.
Some combinations of metric_kind
and value_type
might not be supported.
Generated from protobuf field .google.api.MetricDescriptor.MetricKind metric_kind = 3;
at line 363
int
getValueType()
Whether the measurement is an integer, a floating-point number, etc.
Some combinations of metric_kind
and value_type
might not be supported.
Generated from protobuf field .google.api.MetricDescriptor.ValueType value_type = 4;
at line 376
$this
setValueType(int $var)
Whether the measurement is an integer, a floating-point number, etc.
Some combinations of metric_kind
and value_type
might not be supported.
Generated from protobuf field .google.api.MetricDescriptor.ValueType value_type = 4;
at line 441
string
getUnit()
The unit in which the metric value is reported. It is only applicable
if the value_type
is INT64
, DOUBLE
, or DISTRIBUTION
. The
supported units are a subset of The Unified Code for Units of
Measure standard:
Basic units (UNIT)
* bit
bit
* By
byte
* s
second
* min
minute
* h
hour
* d
day
Prefixes (PREFIX)
* k
kilo (103)
* M
mega (106)
* G
giga (109)
* T
tera (1012)
* P
peta (1015)
* E
exa (1018)
* Z
zetta (1021)
* Y
yotta (1024)
* m
milli (10-3)
* u
micro (10-6)
* n
nano (10-9)
* p
pico (10-12)
* f
femto (10-15)
* a
atto (10-18)
* z
zepto (10-21)
* y
yocto (10-24)
* Ki
kibi (210)
* Mi
mebi (220)
* Gi
gibi (230)
* Ti
tebi (240)
Grammar
The grammar also includes these connectors:
* /
division (as an infix operator, e.g. 1/s
).
.
multiplication (as an infix operator, e.g.GBy.d
) The grammar for a unit is as follows: Expression = Component { "." Component } { "/" Component } ; Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation = "{" NAME "}" ; Notes:Annotation
is just a comment if it follows aUNIT
and is equivalent to1
if it is used alone. For examples,{requests}/s == 1/s
,By{transmitted}/s == By/s
.NAME
is a sequence of non-blank printable ASCII characters not containing '{' or '}'.1
represents dimensionless value 1, such as in1/s
.%
represents dimensionless value 1/100, and annotates values giving a percentage.
Generated from protobuf field string unit = 5;
at line 504
$this
setUnit(string $var)
The unit in which the metric value is reported. It is only applicable
if the value_type
is INT64
, DOUBLE
, or DISTRIBUTION
. The
supported units are a subset of The Unified Code for Units of
Measure standard:
Basic units (UNIT)
* bit
bit
* By
byte
* s
second
* min
minute
* h
hour
* d
day
Prefixes (PREFIX)
* k
kilo (103)
* M
mega (106)
* G
giga (109)
* T
tera (1012)
* P
peta (1015)
* E
exa (1018)
* Z
zetta (1021)
* Y
yotta (1024)
* m
milli (10-3)
* u
micro (10-6)
* n
nano (10-9)
* p
pico (10-12)
* f
femto (10-15)
* a
atto (10-18)
* z
zepto (10-21)
* y
yocto (10-24)
* Ki
kibi (210)
* Mi
mebi (220)
* Gi
gibi (230)
* Ti
tebi (240)
Grammar
The grammar also includes these connectors:
* /
division (as an infix operator, e.g. 1/s
).
.
multiplication (as an infix operator, e.g.GBy.d
) The grammar for a unit is as follows: Expression = Component { "." Component } { "/" Component } ; Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ; Annotation = "{" NAME "}" ; Notes:Annotation
is just a comment if it follows aUNIT
and is equivalent to1
if it is used alone. For examples,{requests}/s == 1/s
,By{transmitted}/s == By/s
.NAME
is a sequence of non-blank printable ASCII characters not containing '{' or '}'.1
represents dimensionless value 1, such as in1/s
.%
represents dimensionless value 1/100, and annotates values giving a percentage.
Generated from protobuf field string unit = 5;
at line 518
string
getDescription()
A detailed description of the metric, which can be used in documentation.
Generated from protobuf field string description = 6;
at line 530
$this
setDescription(string $var)
A detailed description of the metric, which can be used in documentation.
Generated from protobuf field string description = 6;
at line 547
string
getDisplayName()
A concise name for the metric, which can be displayed in user interfaces.
Use sentence case without an ending period, for example "Request count". This field is optional but it is recommended to be set for any metrics associated with user-visible concepts, such as Quota.
Generated from protobuf field string display_name = 7;
at line 562
$this
setDisplayName(string $var)
A concise name for the metric, which can be displayed in user interfaces.
Use sentence case without an ending period, for example "Request count". This field is optional but it is recommended to be set for any metrics associated with user-visible concepts, such as Quota.
Generated from protobuf field string display_name = 7;