监测指标 Container Registry

您可以使用 IBM Cloud® Monitoring 监控 IBM Cloud® Container Registry 账户使用情况的平台指标，并根据这些指标创建警报。

必须在要监控的每个 Container Registry 区域中启用 Container Registry 的平台指标，请参阅启用 Container Registry 的指标。有关 IBM Cloud Monitoring 的更多信息，请参阅 IBM Cloud 中的 Monitoring。

启用指标 Container Registry

您必须在希望查看指标的每个区域启用 Container Registry 指标。

您可以在要监控的区域创建 Monitoring 实例，并为其启用平台指标。或者，也可以在该区域现有的 Monitoring 实例上启用平台指标。

完成以下步骤，为 Container Registry 创建和配置平台指标。

创建并配置一个 IBM Cloud Monitoring 实例，该实例已在要监控的区域内配置了平台指标，请参阅 IBM Cloud Monitoring 入门。

有关启用 Container Registry 进行监控的位置的更多信息，请参阅平台指标位置。
登录到 IBM Cloud。
```
ibmcloud login
```
通过运行 ibmcloud cr region-set 命令。将 REGION 替换为地区名称。
```
ibmcloud cr region-set REGION
```
运行以下命令检查您的账户是否已启用度量功能 ibmcloud cr platform-metrics 命令。该命令还会显示结果适用的注册表。
```
ibmcloud cr platform-metrics --status
```
运行以下 ibmcloud cr platform-metrics 命令，启用平台指标。您的指标可能需要 30 分钟才能生效。
```
ibmcloud cr platform-metrics --enable
```
如果要针对不同的区域，请运行 ibmcloud cr region-set 命令。

您可以在每个区域配置一个监控实例，为 IBM Cloud Container Registry 收集平台指标。下表列出了如果在该区域启用 Container Registry 服务指标收集功能，则可以收集指标的位置。

自动收集 Container Registry 全球服务指标
全球位置	提供平台指标
`Global`	是

有关在何处查看 Container Registry 指标的更多信息，请参阅在何处查找指标。

有关启用 IBM Cloud 服务以向 IBM Cloud Monitoring 发送指标的位置的更多信息，请参阅 IBM Cloud 服务（按位置）。

Container Registry 或 Vulnerability Advisor 指标可用的区域与生成该指标的 Container Registry 的区域相对应。

下表显示了 Monitoring 指标的位置。

Monitoring 指标的位置
帐户注册表的区域	前身为	注册表的域名	Monitoring 指标的位置
`au-syd`	`ap-south`	`au.icr.io`	`Sydney (au-syd)`
`br-sao`	不适用	`br.icr.io`	`Sao Paulo (br-sao)`
`ca-tor`	不适用	`ca.icr.io`	`Toronto (ca-tor)`
`eu-de`	`eu-central`	`de.icr.io`	`Frankfurt (eu-de)`
`eu-es`	不适用	`es.icr.io`	`Madrid (eu-es)`
`eu-gb`	`uk-south`	`uk.icr.io`	`London (eu-gb)`
`jp-osa`	不适用	`jp2.icr.io`	`Osaka (jp-osa)`
`jp-tok`	`ap-north`	`jp.icr.io`	`Tokyo (jp-tok)`
`us-south`	不适用	`us.icr.io`	`Dallas (us-south)`

下表显示了全局注册表 Monitoring 指标的位置。

全球登记册的位置 Monitoring 指标
注册表	全局注册表	Monitoring 指标的位置
`Global`	`icr.io`	`Washington (us-east)`

要监控 Container Registry 指标，必须启动 Monitoring UI 实例，该实例已在使用 Container Registry 的区域为平台指标启用。

要从 Observability 页面启动监控用户界面，请完成以下步骤：

启动监控用户界面。
选择仪表板。
在默认仪表盘部分，展开 IBM.
从列表中选择 Container Registry 仪表板。可用的仪表盘有 Container Registry 使用情况和 Container Registry 配额使用情况。有关预定义仪表盘的更多信息，请参阅预定义仪表盘。

接下来，更改范围或复制默认仪表板，以便在 Container Registry 中监控账户。有关更多信息，请参阅使用仪表板。

下表概述了可用于监控 Container Registry 指标的预定义监控仪表板。

预定义仪表板
仪表板名称	描述	缺省仪表板
Container Registry 使用方法	您可以使用仪表板直观地查看流量使用情况和存储使用情况。流量使用量是指当前计费期内从 Container Registry 命名空间提取图像的字节数总和。存储使用量是 Container Registry 命名空间中图像的字节总和。	是
Container Registry 配额使用情况	您可以使用仪表板直观地查看流量使用情况和存储使用情况，并将数据与配额（如果已设置）进行比较。只有拥有有限配额的账户才能看到。 Container Registry 配额使用情况仪表板只有在启用指标且同时设置了存储和流量配额时才可用。	否

无法更改预定义的仪表盘。您可以复制任何预定义的仪表板，以便根据自己的要求进行更改。有关更多信息，请参阅使用仪表板。

启动仪表板时，某些指标可能会显示 Data Load Error 警告图标。这一警告是因为创建数据需要更多时间。当数据可用时，警告标志就会消失，指标也会被填入。您可能还需要更改分辨周期。

账户当月的拉动流量。

提取流量元数据
元数据	描述
`Metric Name`	`ibm_containerregistry_pull_traffic`
`Metric Type`	`gauge`
`Value Type`	`byte`

账户的拉动流量配额。

提取流量配额元数据
元数据	描述
`Metric Name`	`ibm_containerregistry_pull_traffic_quota`
`Metric Type`	`gauge`
`Value Type`	`byte`

账户的存储配额。

存储配额元数据
元数据	描述
`Metric Name`	`ibm_containerregistry_storage_quota`
`Metric Type`	`gauge`
`Value Type`	`byte`

账户的存储使用量。

存储元数据
元数据	描述
`Metric Name`	`ibm_containerregistry_storage`
`Metric Type`	`gauge`
`Value Type`	`byte`