前提条件

• 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]
   

   説明

   --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

説明

--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を起動し、メトリックを調べます。

また、オープンソースでエンタープライズ対応の Terraform IBM Modules(TIM)を使って、以下のように設定することもできます。 IBM Cloud Monitoring を使うこともできます。 このモジュールは、ベストプラクティスに従って、ターゲットとルートの作成と管理を簡素化します。