先决条件

• 安装 IBM Cloud CLI。

• 安装 IBM Cloud Metrics Routing CLI。

• 您必须拥有有权限管理IBM Cloud Metrics Routing的用户 ID。 有关 IAM 角色及其分配方法的更多信息，请参阅 使用 IAM 管理访问权限 和 分配对IBM Cloud Metrics Routing的访问权限。

• 要配置IBM Cloud Metrics Routing以将指标路由到Monitoring实例，您必须配置服务到服务授权。 您不必向IBM Cloud Metrics Routing提供凭据。

  有关配置服务到服务身份验证的信息，请参阅 管理授权以授予服务之间的访问权限。

步骤 1. 配置帐户设置

设置这些帐户设置以定义使用IBM Cloud Metrics Routing在您的帐户中收集、路由和管理指标的位置和方式。

当您在帐户中配置IBM Cloud Metrics Routing时，您可以配置帐户设置，例如元数据位置、允许管理配置的端点类型、可以定义目标的位置以及在您尚未明确配置如何路由指标的区域中收集指标的默认目标。 有关更多信息，请参阅 配置IBM Cloud Metrics Routing帐户设置。

在配置帐户中的目标和路由之前，您必须配置主要元数据位置，该位置定义存储所有IBM Cloud Metrics Routing资源定义的区域。

运行以下命令来配置主要元数据位置：

ibmcloud metrics-router setting update --primary-metadata-region <REGION>

其中 <REGION> 设置为支持IBM Cloud Metrics Routing的区域。 有关详细信息，请参阅 位置。

在设置元数据位置之前，请检查适用于数据位置的任何合规性或行业法规。

步骤 2. 配置 1 个目标

目标将定义用于收集指标的位置。 有关目标的更多信息，请参阅 了解目标在您账户中的运作方式。

配置目标时，您正在定义计划发送在您账户的某个区域收集的平台指标的目的地。

完成以下步骤配置目标：

1. 定义路由指标的目标。

   ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
   

   Where

   --name

   定义要赋予目标的名称。

   --destination-crn

   定义您计划路由指标的 { IBM Cloud Monitoring实例的 CRN。仅支持IBM Cloud Monitoring目标。

   --region

   [可选]定义创建目标定义的区域。 您只能指定一个 支持的区域。 如果您想在某个区域中创建目标并且已连接到其他区域，请设置此选项。

2. 在IBM Cloud Metrics Routing服务和您在目标中配置为目的地的IBM Cloud Monitoring实例之间定义服务授权。 有关更多信息，请参阅 管理授权以授予服务之间的访问权限。

步骤 3. 配置1条路线

路由定义了一些规则，这些规则指示了在某个区域中路由哪些指标以及将它们存储在何处。 路线在帐户下是全局的，并在部署了IBM Cloud Metrics Routing的所有区域进行评估。 有关更多信息，请参阅 了解路由在您账户中的工作原理。

在此步骤中，您将配置一条路由，将指标重定向到您在上一步中配置的目标目的地。

运行以下命令创建路由：

ibmcloud metrics-router route create --name ROUTE_NAME  --rules RULES

Where

--name ROUTE_NAME

定义赋予路线的名称。

--rules RULES

定义用单引号括起来的 JSON 格式的规则定义。 了解更多信息。

配置路线后，可能需要最多 1 小时才能启用该配置。

例如，要创建一条路由以将在 us-east 中生成的指标发送到您在上一步中创建的目标，请运行以下命令。

ibmcloud metrics-router route create --name "my-route" --rules '[{"action": "send", "targets":[{"id":"TARGETID"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-east"}]}]''

其中，"TARGETID 是您在上一步中创建的目标的 ID。

步骤 4. 验证指标的收集

配置目标和路由后，您必须验证指标是否可用。

启动您配置为目标的 {{site.data.keyword.mon_short} {{site.data.keyword.mon_short}} IBM Cloud Monitoring，并探索指标。