启用度量值监视

要接收监视度量值，必须设置 IBM Cloud Monitoring 实例。

要接收监视度量值，请使用以下步骤:

1. 浏览至 度量值监视门户网站，然后单击 创建监视实例。

2. 选择 IBM Cloud Monitoring 实例的区域。

   如果您没有现有 VPN 服务器，请参阅 创建 VPN 服务器 以供应一个 VPN 服务器。

   该区域需要与现有 VPN 服务器的位置相匹配。

3. 选择定价套餐。 在选择窗口中说明了定价计划详细信息。 选择最符合您要求的计划。

4. 为您的实例提供一个唯一的服务名称。 该名称可以是您想要的任何名称，并且不会影响功能。

   请勿为多个 IBM Cloud Monitoring 实例提供相同的名称。

5. 可选择资源组。 资源组以可定制的分组方式组织帐户资源。 任何通过 IBM Cloud® Identity and Access Management (IAM) 访问控制管理的账户资源都属于账户内的资源组。

   如果您没有任何预先配置的资源组，或者没有理由有选择地共享此资源，请使用缺省选择。

   如果您的帐户具有多个资源组，那么您可以选择哪个组有权访问此 IBM Cloud Monitoring 实例。 通过使用此选择性访问，度量可以供某些资源组使用，而不能供其他资源组使用。

6. 选中 启用平台度量 复选框。 必须选择此选项才能从 VPN 服务器接收度量值。

7. 单击创建。 您将返回到监视度量主页。

在几分钟内，将显示具有多个配置的新 IBM Cloud Monitoring 实例。 您可能必须刷新浏览器才能看到该浏览器。

使用 API 处理 IBM Cloud Monitoring

您还可以使用度量值查询 API 来处理 IBM Cloud Monitoring 实例。 如果您需要原始数据点或希望从命令行界面使用度量，而不是使用 IBM Cloud Monitoring 仪表板，那么可能需要使用 API。

创建 IBM Cloud Monitoring 实例后，必须收集以下两部分信息。

• Monitor API 令牌
• IBM Cloud Monitoring 实例的端点

要收集此信息并使用度量值查询 API 处理 IBM Cloud Monitoring 实例，请执行以下步骤:

1. 访问 Monitoring 主页。

2. 单击要使用的实例旁边的 打开仪表板。

3. 看到 IBM Cloud Monitoring 仪表板后，请在侧边栏上选择“帐户概要文件”图标，然后选择 设置。 现在，您将看到您的帐户设置。

4. Monitor API 令牌是位于 Sysdig Monitor API 令牌 字段中的字母数字字符串。 单击“复制”按钮，将标记复制到剪贴板。

   请勿共享此 API 令牌。 具有此 API 令牌的任何人都具有对度量值的完全访问权。

5. IBM Cloud Monitoring 实例的端点是每个区域的端点。 例如，如果 IBM Cloud Monitoring 实例存在于 us-south 中，那么其端点为:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

   URL 的第一部分（在本例中为 us-south.monitoring.cloud.ibm.com ）是您的终端。 请注意 URL。

6. 在同时具有 API 令牌和端点之后，可以格式化 POST 请求。 以下 POST 请求是一个示例，其中包含您可以修改的所有参数。 以下是参数:

   • Monitor API 令牌。
   • IBM Cloud Monitoring 实例的端点。
   • ibm_is_vpn_server_name 的值 (要查看其度量值的 VPN 服务器名称)。

   如果要查看所有 VPN 服务器的此度量，请勿输入 scope 属性的值。 例如，使用 "scope" : ""。

   • 要查看其结果的度量标准类型。 本例使用 ibm_is_vpn_server_health_status。
   • from 和 to 属性定义聚焦扫描的时间范围，以戳记时间和微秒为单位设置。
   • sampling 和 value 属性设置 POST 请求中返回的数据的详细程度。

由于大量数据存储在 IBM Cloud Monitoring中，因此选择特定粒度级别很重要。对于每个请求，IBM Cloud Monitoring 一次只能返回 600 个数据点。 因此，sampling 和 value 属性很重要。 如果将这两行保留在请求之外，那么将返回该时间段内的汇总总和。

如果 from 和 to 指定的时间范围较大 (例如，4 天)，但您定义 sampling 和 value 为 10 秒，那么这意味着您将接收到 4 天的数据，这些数据将拆分为 10 秒区块。 由于返回的数据量很大，因此此样本无用。 建议指定较大的块 (例如，1 小时而不是 10 秒)。

   curl \
   -H 'Authorization: Bearer <API_TOKEN>’ \
   -H 'Content-Type: application/json' \
   https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
   -d '{
     "requests": [
         {
             "format": {
                 "type": "data"
             },
             "scope": "ibm_is_vpn_server_name = \"test-001\"",
             "metrics": {
                 "k0": "timestamp",
                 "v1": "ibm_is_vpn_server_health_status"
             },
             "time": {
                 "from": 1624849800000000,
                 "to": 1624850400000000,
                 "sampling": 60000000
             },
             "group": {
                 "by": [
                     {
                        "metric": "k0",
                         "value" : 60000000
                     }
                 ],
                 "aggregations": {
                     "v1": "avg"
                 },
                 "groupAggregations": {
                     "v1": "avg"
                 }
             }
         }
     ]
 }'