Data model in Monitoring
Yandex Monitoring stores data as time series.
Metrics
Metric is a timeseries that shows a change of some value over time. For example, the resource status of a Yandex Cloud service: the amount of used disk space, network data transfer rate, and so on.
Metrics are identified using text labels.
Labels
A label is a metric characteristic in key: "value" format. Each metric is identified by an unordered set of labels. Use a parameter that takes a limited set of values as a label. For example, the HTTP status code, the types of procedures being performed in a database, and so on.
The service has mandatory and optional labels. Mandatory labels:
cloudId: ID of the cloud the resource belongs to.folderId: ID of the folder the resource belongs to.service: Indicates the Yandex Cloud service that the resource belongs to. For example,computeormanaged-postgresql.
Warning
When uploading custom metrics, you should write the custom value in the service label.
Label constraints and their values
The following constraints apply to labels and their values:
- A metric can have no more than 16 labels, including the mandatory
cloudId,folderId, andservicelabels. - Label name cannot be empty.
- Label name cannot include the
-character. - Name length: 32 characters or less.
- Label name must start with an uppercase or lowecase letter and may contain letters, digits, the
.and_characters. - Label names and metric values cannot include any non-Latin letters.
Metric types
The Yandex Monitoring service offers the following metric types:
| Type | Description |
|---|---|
DGAUGE |
Numeric value (decimal). It shows the metric value at a certain point in time. For example, the amount of used RAM. |
IGAUGE |
Numeric value (integer). It shows the metric value at a certain point in time. |
COUNTER |
Counter. It shows the metric value that increases over time. For example, the number of days of service continuous running. |
RATE |
Derivative value. It shows the change in the metric value over time. For example, the number of requests per second. |
Queries
A query is an arbitrary expression in the query language that results in a line or a set of lines. Query text may refer to the results of higher-level queries as variables.
Monitoring allows you to create queries to select a set of metrics and display them on a chart. You can also use templates as label values.
The following templates are available in Monitoring:
| Syntax | Description |
|---|---|
label="*" |
Outputs all metrics with the specified label. For example, the host="*" query displays all metrics with host label. |
label="glob" |
Displays all metrics whose label value matches a glob expression:*: Any number of characters (including none). For example, name="folder*" displays all metrics that have the name label and whose value begins with the folder prefix.?: One arbitrary character. For example, name="metric?" displays all labels that have one character after metric` |