Azure Monitor 度量集

编辑

这是 Azure 模块的监控度量集。

此度量集允许用户从指定资源检索指标。可以在这里添加过滤器,例如检索这些指标的时间间隔、指标名称、聚合列表、命名空间和指标维度。

度量集特定配置说明

编辑
refresh_list_interval
每次提取调用(period 间隔)都会检索资源,这意味着每次都会执行多个 Azure REST 调用。如果 Azure 用户添加/删除与配置选项匹配的资源,这将非常有用,这样它们就不会添加到列表或从列表中删除。为了减少每次检索资源时执行的 API 调用次数,用户可以配置此设置,并确保不会频繁刷新资源列表。这也有利于性能和速率/成本方面(https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limits)。
resources
这将包含用于识别资源和配置所需指标的所有选项。

识别资源的配置选项

编辑
resource_id
([]string) 资源的完全限定 ID,包括资源名称和资源类型。格式为 /subscriptions/{guid}/resourceGroups/{resource-group-name}/providers/{resource-provider-namespace}/{resource-type}/{resource-name}。应返回资源列表。

但是用户可能需要收集大量资源的指标,因此,为了减少冗余,用户可以选择输入资源组并按资源类型进行筛选,或者输入“resource_query”,用户可以在其中筛选其整个订阅中的资源。资源 API 的来源:https://docs.microsoft.com/en-us/rest/api/resources/resources/list https://docs.microsoft.com/en-us/rest/api/resources/resources/listbyresourcegroup

resource_group
([]string) 需要使用 resource_type 配置选项作为输入资源组的过滤器。此选项应返回我们想要在其上应用指标配置选项的资源列表。
resource_type
(string) 如上所述,这将是资源组 API 的筛选选项,将检查该组下所有指定类型的资源。
resource_query
(string) 应包含用户输入的筛选器,输出将是资源列表。

资源指标配置

编辑
metrics
收集信息的各种指标列表。
namespace
(string) 命名空间是将类似指标分类或分组的一种方式。通过使用命名空间,用户可以在可能收集不同见解或性能指标的指标组之间实现隔离。
name
([]string) 报告的指标名称。通常,名称具有足够的描述性,有助于识别所测量的内容。也可以输入指标名称列表。
aggregations
([]string) 受支持的聚合列表。Azure Monitor 以一分钟的粒度间隔存储所有指标。在一分钟内,可能需要对指标进行多次采样,或者可能需要对许多离散事件进行测量。为了限制我们必须在 Azure Monitor 中发出和支付的原始值的数量,它们将本地预先聚合并发出这些值:最小值:在一分钟内所有样本和测量中观察到的最小值。最大值:在一分钟内所有样本和测量中观察到的最大值。总和:在一分钟内所有样本和测量中观察到的所有值的总和。计数:在一分钟内获取的样本和测量的数量。总计:在一分钟内所有样本和测量中观察到的所有值的总数。
dimensions
指标维度的列表。维度是可选的,并非所有指标都可能有维度。自定义指标最多可以有 10 个维度。维度是一对键值对,有助于描述有关正在收集的指标的附加特征。通过使用附加特征,您可以收集有关指标的更多信息,从而获得更深入的见解。通过使用此键,您可以过滤指标以查看特定进程使用了多少内存,或者按内存使用情况识别前五个进程。具有维度的指标作为扁平化的单维度指标导出,并跨维度值聚合。
name
维度键
维度值。(用户可以选择 * 以返回每个维度的指标值)
ignore_unsupported
(bool) 某些资源可能不支持命名空间,而某些资源可能支持,此配置选项确保在命名空间不受支持时不会返回错误消息。配置的指标也是如此,某些指标可能会从 Azure Monitor 中删除,并且不应影响模块的状态。

用户可以选择以下选项来检索来自特定命名空间的所有指标。

 metrics:
 - name: ["*"]
   namespace: "Microsoft.Storage/storageAccounts"

如果未在指标级别输入任何聚合,则度量集将检索为此指标分配的主要聚合。

这是一个默认度量集。如果主机模块未配置,则默认情况下启用此度量集。

字段

有关度量集中的每个字段的说明,请参见导出字段部分。

这是一个由该度量集生成的示例文档。

{
    "@timestamp": "2017-10-12T08:05:34.853Z",
    "azure": {
        "dimensions": {
            "activity_name": "secretlist"
        },
        "metrics": {
            "availability": {
                "avg": 100
            }
        },
        "namespace": "Microsoft.KeyVault/vaults",
        "resource": {
            "group": "some-rg",
            "id": "/subscriptions/70f046a0-a299-ab73-9950-88ac8b5ac454/resourceGroups/some-rg/providers/Microsoft.KeyVault/vaults/somekeyvault",
            "name": "somekeyvault",
            "type": "Microsoft.KeyVault/vaults"
        },
        "subscription_id": "70bd6e64-4b1e-4835-8896-db77b8eef364",
        "timegrain": "PT1M"
    },
    "cloud": {
        "provider": "azure",
        "region": "westeurope"
    },
    "event": {
        "dataset": "azure.monitor",
        "duration": 115000,
        "module": "azure"
    },
    "metricset": {
        "name": "monitor",
        "period": 10000
    },
    "service": {
        "type": "azure"
    }
}