UIを使用したターゲットの作成

UIを使用してターゲットを作成するには、以下を実行する。

あなたのアカウントにあるリソースのみがリストアップされ、選択可能です。 別のアカウントでリソースを指定するには、保存先の選択の下にある CRNの指定を選択します。

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン > **「可観測性」**をクリックします。

3. **「モニタリング」**をクリックします。

4. ルーティングをクリックします。

5. **「ターゲット」**タブをクリックします。

6. 作成をクリックして、作成パネルを開きます。

7. Service authorization required: IBM Cloud Metrics RoutingがIBM Cloud Monitoringと通信するためには、サービスの認証が必要です。 ポリシーを自動的に作成するには Authorize now をクリックするか、Grant access in IAM をクリックします。

8. 保存先を選択します：インスタンスで検索または CRNを指定を選んでください

   • インスタンスで検索: IBM Cloud Monitoringインスタンスをテーブルから選択するか、作成をクリックして新しいIBM Cloud Monitoringインスタンスを作成します。
   • Specify CRN: IBM Cloud Monitoringインスタンスのクラウドリソース名（CRN）を入力します。 これにより、別のアカウントからCRNを入力することができます。

9. ターゲットの詳細を指定する。

• ターゲット名：ターゲットに意味のある名前を入力します。

• 対象地域：対象地域を選択する。

• デフォルト・ターゲットとして設定を切り替えると、IBM Cloud Metrics Routing設定のデフォルト・ターゲットとして新しいターゲットが自動的に設定されます。 詳しくは デフォルトターゲットのドキュメント を参照してください。

11. ターゲットを作成をクリックします。

UIを使用したターゲットの更新

UIを使用してターゲットを更新するには、以下を実行する。

あなたのアカウントにあるリソースのみがリストアップされ、選択可能です。 別のアカウントでリソースを指定するには、保存先の選択の下にある CRNの指定を選択します。

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン > **「可観測性」**をクリックします。

3. **「モニタリング」**をクリックします。

4. ルーティングをクリックします。

5. **「ターゲット」**タブをクリックします。

6. 更新するターゲットを決定し、 をクリックします。

7. Unset as default をクリックして、IBM Cloud Metrics Routing 設定のデフォルト・ターゲットとしてターゲットを削除します。 詳しくは デフォルトターゲットのドキュメント を参照してください。

8. 編集をクリックして更新パネルを開く。

9. 詳細をクリックします：編集をクリックし、ターゲット名を更新します。 また、IBM Cloud Metrics Routing設定で、デフォルト・ターゲットを切り替えて、デフォルト・ターゲットとしてターゲットを追加または削除することもできます。

   また、ターゲットに関連するルートを表示することもできます。

10. 保存をクリックしてターゲットを更新します。

11. 目的地をクリックします：Edit をクリックして、ターゲットに関連付けられているIBM Cloud Monitoringインスタンスを変更します。

12. 保存をクリックしてターゲットを更新します。

UIを使用したターゲットの削除

UIを使用してターゲットを削除するには、以下の手順を実行する。

IBM Cloud Metrics Routingターゲットがルート内またはデフォルト・ターゲット設定として使用されている場合は、削除できません。

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン > **「可観測性」**をクリックします。

3. **「モニタリング」**をクリックします。

4. ルーティングをクリックします。

5. **「ターゲット」**タブをクリックします。

6. 更新するターゲットを決定し、 をクリックします。

7. 削除をクリックし、確認パネルで削除をクリックします。

UIを使った全ターゲットのリストアップ

UIを使用してすべてのターゲットをリストアップするには、以下の手順を実行する。

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン > **「可観測性」**をクリックします。

3. **「モニタリング」**をクリックします。

4. ルーティングをクリックします。

5. **「ターゲット」**タブをクリックします。

表はそれを示している：

• ターゲット・タイプ

• 宛先名

• 宛先リージョン

• ルート: ターゲットが定義されたルートで使われる場合のルートの数。

CLI の前提条件

CLI を使用してターゲットを管理する前に、以下の手順を実行します。

1. IBM Cloud CLI をインストールします。

2. IBM Cloud Metrics Routing CLI をインストールします。

3. IBM Cloud にログインします。 次のコマンドを実行します。 ibmcloud login

4. IBM Cloud Metrics Routing の経路またはターゲットを構成する前に、1 次メタデータ領域を構成する必要があります。 1 次メタデータ領域は、 ibmcloud metrics-router setting update コマンドの --primary-metadata-region オプションを使用して構成されます。

CLIを使用したMonitoringターゲットの作成

このコマンドを使用してMonitoringターゲットを作成し、プラットフォーム・メトリクスのデスティ ネーションを構成します。

ターゲット名はアカウント内で固有です。

ibmcloud metrics-router target create --name TARGET_NAME --destination-crn CRN_VALUE [--region REGION] [--output FORMAT]

Target
Name:               		my-target
ID:                 		000000000-00000000-0000-0000-00000000
REGION:                         us-east
Type:               		sysdig_monitor
Destination CRN:     		crn:v1:bluemix:public:sysdig-monitor:au-syd:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx::
CreatedAt:            		2021-07-21T16:04:15.174Z
UpdatedAt:            		2021-07-21T16:04:15.174Z

CLIを使用したMonitoringターゲットの更新

このコマンドを使用して、Monitoringターゲットを更新する。 ターゲットおよび宛先 CRN の名前を変更することができます。 ターゲットが最初に作成された時の値とは異なる値をコマンドで指定すると、その値がコマンドの指定値に更新されます。

ターゲット名はアカウント内で固有です。

ibmcloud metrics-router target update --target TARGET [--name TARGET_NAME] [--destination-crn DESTINATION_TARGET_CRN] [--output FORMAT]

Target
Name:               		my-new-target-name
ID:                 		000000000-00000000-0000-0000-00000000
REGION:                         us-east
CRN:                		crn:v1:bluemix:public:metrics-router:us-south:a/xxxxxxxxxx:000000000-00000000-0000-0000-00000000
Type:               		sysdig_monitor
Destination CRN:     		crn:v1:bluemix:public:sysdig-monitor:au-syd:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx::
CreatedAt:            		2021-07-21T16:04:15.174Z
UpdatedAt:            		2021-07-21T16:04:15.174Z

CLI を使用したターゲットの削除

このコマンドは、ターゲットを削除するために使用します。

ibmcloud metrics-router target rm --target TARGET [--force]

Are you sure you want to remove the target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx? [y/N]>y
OK
Target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx was successfully removed.

CLI を使用したターゲットに関する情報の取得

このコマンドを使用して、IBM Cloud Metrics Routing リージョンのターゲットに関する情報を取得します。

ibmcloud metrics-router target get --target TARGET [--output FORMAT]

Name:               		my-target
ID:                 		000000000-00000000-0000-0000-00000000
REGION:                         us-east
CRN:                		crn:v1:bluemix:public:metrics-router:us-south:a/xxxxxxxxxx:000000000-00000000-0000-0000-00000000
Type:               		sysdig_monitor
Destination CRN:     		crn:v1:bluemix:public:sysdig-monitor:au-syd:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx::
CreatedAt:            		2021-07-21T16:04:15.174Z
UpdatedAt:            		2021-07-21T16:04:15.174Z

リージョン内のすべてのターゲットのリスト

このコマンドを使用して、IBM Cloud Metrics Routing リージョンの構成済みターゲットを表示します。

ibmcloud metrics-router target ls [--output FORMAT]

Name                       ID                                     Region     Type              	CreatedAt                   UpdatedAt
target-01                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   us-south    sysdig_monitor    2020-11-18T03:52:08.603Z    2020-11-19T03:52:08.603Z
target-02                  yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy   us-south    sysdig_monitor    2020-11-18T03:52:01.592Z    2020-11-19T03:52:08.603Z
target-02-backup           zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz   us-east     sysdig_monitor    2021-02-26T06:53:13.466Z    2020-11-19T03:52:08.603Z

API のターゲットとアクション

次の表は、ターゲットを管理するために実行できるアクションのリストです。

プライベート・エンドポイントとパブリック・エンドポイントを使用してターゲットを管理することができます。 使用可能な ENDPOINTS のリストについて詳しくは、エンドポイントを参照してください。

• https://private.REGION.metrics-router.cloud.ibm.comという形式の API エンドポイントを使用して、プライベート・ネットワークからターゲットを管理できます。

• https://REGION.metrics-router.cloud.ibm.comという形式の API エンドポイントを使用して、パブリック・ネットワークからターゲットを管理できます。

• アカウント設定を更新することで、パブリック・エンドポイントを無効にすることができます。 詳しくは、ターゲットとリージョンの設定の構成を参照してください。

REST API について詳しくは、 ターゲットを参照してください。

API の前提条件

ターゲットを管理するための API 呼び出しを行うには、以下のステップを実行します。

1. IAM アクセス・トークンを取得します。 詳しくは、IAM アクセス・トークンの取得を参照してください。
2. ターゲットを構成または管理する予定のリージョン内の API エンドポイントを特定します。 詳しくは、エンドポイントを参照してください。
3. IBM Cloud Metrics Routing の経路またはターゲットを構成する前に、1 次メタデータ領域を構成する必要があります。 1 次メタデータ領域は、 設定の変更 API メソッド を使用して構成されます。

APIを使用したMonitoringターゲットの作成

以下のcURLコマンドを使用して、Monitoringターゲットを作成することができます：

ターゲット名はアカウント内で固有です。

curl -X POST <ENDPOINT>/api/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CRN"
  }'

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。

• TARGET_NAME は、ターゲットの名前です。 この名前の最大長は 256 文字です。

  リソース名に個人識別情報 (PII) を含めないでください。

• CRN は、 Monitoring インスタンスの CRN を示します。

例えば、次の cURL 要求を使用して、ダラスにターゲットを作成できます。

curl -X POST https://private.us-south.metrics-router.cloud.ibm.com/api/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My-target",
    "target_type": "crn:v1:bluemix:public:sysdig-monitor:au-syd:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx::"
  }'

応答では、ターゲットの GUID を示す id やターゲットの CRN を示す crn など、ターゲットに関する情報が得られます。

APIを使用したMonitoringターゲットの更新

ターゲットおよび宛先 CRN の名前を変更することができます。 ターゲットが最初に作成されたときと異なる指定された値は、リクエストで指定された値に更新される。

Monitoringターゲットを更新する場合、リクエストのデータセクションにターゲット情報を含める必要があります。

• すべてのフィールドを渡す必要があります。
• 変更する必要があるフィールドを更新します。

ターゲット名はアカウント内で固有です。

以下の cURL コマンドを使用して、ターゲットを更新できます。

curl -X PATCH <ENDPOINT>/api/v3/targets/TARGET_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CRN"
  }'

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。

• TARGET_IDはターゲットの ID です。

• TARGET_NAME は、ターゲットの名前です。 この名前の最大長は 256 文字です。

  リソース名に個人識別情報 (PII) を含めないでください。

• CRN は、 Monitoring インスタンスの CRN を示します。

例えば、次の cURL 要求を使用して、ダラスにターゲットを作成できます。

curl -X PATCH https://private.us-south.metrics-router.cloud.ibm.com/api/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My target",
    "destination_crn": "crn:v1:bluemix:public:sysdig-monitor:au-syd:a/<account-id>:<instance-id>::"
    }
  }'

API を使用したターゲットの削除

以下の cURL コマンドを使用して、ターゲットを削除できます。

curl -X DELETE <ENDPOINT>/api/v3/targets/<TARGET_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。
• <TARGET_ID>はターゲットの ID です。

例えば、ID '00000000-0000-0000-0000-000000000000 を持つターゲットを削除するには、次のようなcURLリクエストを使用します：

curl -X DELETE https://private.us-south.metrics-router.cloud.ibm.com/api/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

API を使用したターゲットの表示

次の cURL コマンドを使用して、1 つのターゲットの構成の詳細を表示することができます。

curl -X GET <ENDPOINT>/api/v3/targets/<TARGET_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。
• <TARGET_ID>はターゲットの ID です。

例えば、以下の cURL 要求を実行して、ID 00000000-0000-0000-0000-000000000000のターゲットに関する情報を取得できます。

curl -X GET https://private.us-south.metrics-router.cloud.ibm.com/api/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

API を使用したすべてのターゲットのリスト表示

次の cURL コマンドを使用して、すべてのターゲットを表示できます。

curl -X GET <ENDPOINT>/api/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

説明

• <ENDPOINT>は、ターゲットを構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。

例えば、以下の cURL 要求を実行して、ダラスで定義されているターゲットに関する情報を取得できます。

curl -X GET https://private.us-south.metrics-router.cloud.ibm.com/api/v3/targets -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

HTTP 応答コード

IBM Cloud Metrics Routing REST API を使用すると、メソッドが正常に完了したかどうかを示す標準 HTTP 応答コードを取得できます。

• 200 応答は、どのような場合でも成功を示しています。
• 4xx 応答は、失敗を示しています。
• 5xx応答は内部システムエラーを示す。

いくつかの HTTP 応答コードについては、以下の表を参照してください。