我是 Google API 的新手,我正在通过 API 收集监控指标信息。
对于 CPU 利用率,我正在使用此 API:
https://monitoring.googleapis.com/v3/projects/my-project/timeSeries?pageSize=500&interval.startTime=2020-07-13T17:30:06Z&aggregation.alignmentPeriod=3600s&aggregation.perSeriesAligner=align_SUM&filter=metric.type = "compute.googleapis.com/instance/cpu/utilization" AND metric.labels.instance_name="my-instancename"&pageToken=&interval.endTime=2020-07-14T17:30:06Z&alt=json&aggregation.groupByFields=metric.labels.key
我已将对齐器指定为align_sum 和度量类型
compute.googleapis.com/instance/cpu/utilization
累计对齐周期为3600s
并且利用率以双值的形式出现
这是从 2020-07-14T16:30:06Z 开始到 2020-07-13T18:30:06Z 结束的结果
{
"timeSeries": [
{
"metric": {
"labels": {
"instance_name": "my-instancename"
},
"type": "compute.googleapis.com/instance/cpu/utilization"
},
"resource": {
"type": "gce_instance",
"labels": {
"project_id": "my-project",
"zone": "us-central1-a",
"instance_id": "734343433"
}
},
"metricKind": "GAUGE",
"valueType": "DOUBLE",
"points": [
{
"interval": {
"startTime": "2020-07-14T16:30:06Z",
"endTime": "2020-07-14T16:30:06Z"
},
"value": {
"doubleValue": 7.6894335467752173
}
},
{
"interval": {
"startTime": "2020-07-14T15:30:06Z",
"endTime": "2020-07-14T15:30:06Z"
},
"value": {
"doubleValue": 10.759589985275971
}
},
{
"interval": {
"startTime": "2020-07-14T14:30:06Z",
"endTime": "2020-07-14T14:30:06Z"
},
"value": {
"doubleValue": 12.316655567177508
}
},
{
"interval": {
"startTime": "2020-07-14T13:30:06Z",
"endTime": "2020-07-14T13:30:06Z"
},
"value": {
"doubleValue": 12.728700633146035
}
},
{
"interval": {
"startTime": "2020-07-14T12:30:06Z",
"endTime": "2020-07-14T12:30:06Z"
},
"value": {
"doubleValue": 12.727092186095067
}
},
{
"interval": {
"startTime": "2020-07-14T11:30:06Z",
"endTime": "2020-07-14T11:30:06Z"
},
"value": {
"doubleValue": 12.653159778132306
}
},
{
"interval": {
"startTime": "2020-07-14T10:30:06Z",
"endTime": "2020-07-14T10:30:06Z"
},
"value": {
"doubleValue": 12.760028718919907
}
},
{
"interval": {
"startTime": "2020-07-14T09:30:06Z",
"endTime": "2020-07-14T09:30:06Z"
},
"value": {
"doubleValue": 13.468505218942028
}
},
{
"interval": {
"startTime": "2020-07-14T08:30:06Z",
"endTime": "2020-07-14T08:30:06Z"
},
"value": {
"doubleValue": 13.517169812102356
}
},
{
"interval": {
"startTime": "2020-07-14T07:30:06Z",
"endTime": "2020-07-14T07:30:06Z"
},
"value": {
"doubleValue": 13.608358825287452
}
},
{
"interval": {
"startTime": "2020-07-14T06:30:06Z",
"endTime": "2020-07-14T06:30:06Z"
},
"value": {
"doubleValue": 13.53897596539931
}
},
{
"interval": {
"startTime": "2020-07-14T05:30:06Z",
"endTime": "2020-07-14T05:30:06Z"
},
"value": {
"doubleValue": 13.546214478312317
}
},
{
"interval": {
"startTime": "2020-07-14T04:30:06Z",
"endTime": "2020-07-14T04:30:06Z"
},
"value": {
"doubleValue": 13.438030445192032
}
},
{
"interval": {
"startTime": "2020-07-14T03:30:06Z",
"endTime": "2020-07-14T03:30:06Z"
},
"value": {
"doubleValue": 13.540240797295567
}
},
{
"interval": {
"startTime": "2020-07-14T02:30:06Z",
"endTime": "2020-07-14T02:30:06Z"
},
"value": {
"doubleValue": 13.445462736608853
}
},
{
"interval": {
"startTime": "2020-07-14T01:30:06Z",
"endTime": "2020-07-14T01:30:06Z"
},
"value": {
"doubleValue": 13.628532548211796
}
},
{
"interval": {
"startTime": "2020-07-14T00:30:06Z",
"endTime": "2020-07-14T00:30:06Z"
},
"value": {
"doubleValue": 13.595787295526025
}
},
{
"interval": {
"startTime": "2020-07-13T23:30:06Z",
"endTime": "2020-07-13T23:30:06Z"
},
"value": {
"doubleValue": 13.612668592590264
}
},
{
"interval": {
"startTime": "2020-07-13T22:30:06Z",
"endTime": "2020-07-13T22:30:06Z"
},
"value": {
"doubleValue": 13.508062526394571
}
},
{
"interval": {
"startTime": "2020-07-13T21:30:06Z",
"endTime": "2020-07-13T21:30:06Z"
},
"value": {
"doubleValue": 13.557865914903669
}
},
{
"interval": {
"startTime": "2020-07-13T20:30:06Z",
"endTime": "2020-07-13T20:30:06Z"
},
"value": {
"doubleValue": 13.615398551388523
}
},
{
"interval": {
"startTime": "2020-07-13T19:30:06Z",
"endTime": "2020-07-13T19:30:06Z"
},
"value": {
"doubleValue": 13.59927301647136
}
},
{
"interval": {
"startTime": "2020-07-13T18:30:06Z",
"endTime": "2020-07-13T18:30:06Z"
},
"value": {
"doubleValue": 13.576294740418575
}
}
]
}
],
"unit": "10^2.%"
}
由于我不熟悉这个 API,我无法正确解释结果。
下面的结果对于这个时间段意味着什么?我给出了总计 3600 秒,这是否意味着每 1 小时(即 2020-07-14T01:30:06Z 到 2020-07-14T012:30:06Z)CPU 在该时段或仅在该实例点使用了这么多2020-07-14T01:30:06Z 已经利用了这么多。由于该指标指标的开始时间和结束时间相同,因此我需要对此有所了解。我已经给了 ALIGN_SUM 那么显示的值是 1 小时的总和吗?
"interval": {
"startTime": "2020-07-14T01:30:06Z",
"endTime": "2020-07-14T01:30:06Z"
},
"value": {
"doubleValue": 13.628532548211796
}
此利用率的单位也给出为
"unit": "10^2.%".
我是否应该通过进一步潜水(13.62/100)将此利用率值转换为百分比以在图表中表示?我需要对此进行报告。
在通过Google API读取和收集监控指标信息方面,我建议参考this有关读取指标数据的文档。本文档介绍了如何使用监控 API 中的 timeSeries.list 方法读取指标数据(也称为时间序列数据)。
此外,通过上面的文档,您还将找到获取时间序列数据的示例,该示例应详细解释如何分解这些日志以及如何利用它来发挥您的优势。
此外,就该利用率的unit而言,给出为
"unit": "10^2.%"
,它基于我们关于方法的文档:projects.timeSeries.list。正如我们所看到的,unit 保存项目中报告的所有时间序列点值。该单位遵循 UCUM 单位格式,如 https://unitsofmeasure.org/ucum.html 所示。此外,如果不同的 timeSeries 有不同的单位(例如,因为它们来自不同的指标类型,或者缺少单位),则单位将为“{not_a_unit}”。