メトリック・モニタリングの有効化

モニタリング・メトリックを受信するには、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 インスタンスがいくつかの構成とともに表示されます。 場合によっては、このインスタンスを表示するためにブラウザーを最新表示する必要があります。

IBM Cloud Monitoring ダッシュボードの操作

IBM Cloud Monitoring メトリックを表示して操作するには、以下の手順を実行します。

1. メトリック・モニター・ポータルにナビゲートします。

2. 操作する IBM Cloud Monitoring インスタンスのサービス名の横にある**「ダッシュボードを開く (Open dashboard)」**をクリックします。

   IBM Cloud Monitoring インスタンスに初めてアクセスしたときは、いくつかのウィンドウが内部セットアップの一部として表示されます。 デフォルトの入力値のままにしておき、IBM Cloud Monitoring のメインページが表示されるまで、クリックして次のページに進みます。

3. **「ダッシュボード」**を選択して、IBM VPN for VPC の「モニタリング・メトリック」ダッシュボードを開きます。

4. 「ダッシュボード・ライブラリー」>「 IBM 」>「VPC VPN」 をクリックします。 デフォルトのダッシュボードは編集できません。

5. ダッシュボードに 10 個の主要なメトリックが表示されます。 例えば、ゲートウェイ/接続状況、ゲートウェイ/接続入出力バイト数、ゲートウェイ/接続入出力パケット数などのメトリックがあります。 パラメーターを変更し、メトリックを VPN ゲートウェイ名と VPN 接続名でセグメント化する場合は、カスタム・ダッシュボードを作成する必要があります。

   時間選択バーを使用して、メトリックを表示する時間枠を選択できます。

カスタム・メトリック・ダッシュボードの作成

独自のダッシュボードを作成してモニタリング・メトリックをカスタマイズできます。例えば、特定の VPN ゲートウェイに関する情報を表示したり、ある VPN 接続から送信されてきたトラフィックだけを表示したりできます。

ダッシュボードをカスタマイズするには、以下の手順を使用します。

1. メトリック・モニター・ポータルにナビゲートします。

2. 操作する IBM Cloud Monitoring インスタンスのサービス名の横にある**「ダッシュボードを開く (Open dashboard)」**をクリックします。 これでダッシュボードが表示されます。

3. **「ダッシュボード」を選択し、パネルにある「+」**をクリックします。

4. **「ブランク・ダッシュボード (Blank dashboard)」**を選択し、目的の視覚表現のタイプを選択します。

   IBM Cloud Monitoring では、ダッシュボード用に 8 種類の視覚表現が提供されます。 各視覚表現の説明を読み、要件に最も合うものを選択してください。

   **「一定期間にわたる傾向の表示 (View trends over time)」**という折れ線グラフが最もよく選択されるオプションです。 次の例は、折れ線ベースの視覚表現を示しています。

5. カスタム・ダッシュボードを構成します。

   • Metrics] フィールドに ibm_is と入力すると、VPC メトリクスの IBM Cloud VPN が 10 個表示されます： ibm_is_vpn_gateway_status ibm_is_vpn_connection_status, ibm_is_vpn_gateway_bytes_in, ibm_is_vpn_gateway_bytes_out, ibm_is_vpn_gateway_packets_in, ibm_is_vpn_gateway_packets_out, ibm_is_vpn_connection_bytes_in, ibm_is_vpn_connection_bytes_out, ibm_is_vpn_connection_packets_in, and ibm_is_vpn_connection_packets_out。

   • ダッシュボードに表示する範囲を選択するには、**「ダッシュボード範囲のオーバーライド (Override Dashboard Scope)」**をクリックします。 例えば、特定の VPN ゲートウェイのメトリックを表示することができます。

   • また、定義する範囲全体にわたってメトリックを比較するためのセグメントを設定することもできます。 例えば、特定の VPN ゲートウェイの接続状況を、ゲートウェイ名と接続名でセグメント化して表示することができます。

6. 保存 をクリックします。

   デフォルトでは、ダッシュボードの名前は「ブランク・ダッシュボード (blank dashboard)」になります。 サイドバーからダッシュボードを選択し、名前の横にある編集アイコン クリックすると、名前を変更できます。

いつでも**「ダッシュボード」>「デフォルト・ダッシュボード (Default Dashboards)」>「IBM」>「VPC VPN」**を選択して、デフォルトの IBM Cloud Monitoring ダッシュボードに戻ることができます。

API を使用した IBM Cloud Monitoring の操作

メトリック照会 API を使用して IBM Cloud Monitoring インスタンスを操作することもできます。 未加工のデータ・ポイントが必要な場合や、IBM Cloud Monitoring ダッシュボードを使用するのではなくコマンド・ライン・インターフェースでメトリックを使用したい場合などに、API を使用することをお勧めします。

IBM Cloud Monitoring インスタンスを作成した後に、以下の 2 つの情報を取得する必要があります。

• Monitor API トークン
• IBM Cloud Monitoring インスタンスのエンドポイント

この情報を取得し、メトリック照会 API を使用して IBM Cloud Monitoring インスタンスを操作するには、以下の手順を実行します。

1. モニタリングのホーム・ページにアクセスします。

2. 操作するインスタンスの横にある**「ダッシュボードを開く (Open Dashboard)」**をクリックします。

3. IBM Cloud Monitoring ダッシュボードが表示されたら、サイドバーにある「アカウント・プロファイル (Account Profile)」アイコンを選択して、**「設定」**を選択します。 これでアカウント設定が表示されます。

4. Monitor API トークンは、**「Sysdig Monitor API トークン (Sysdig Monitor API Token)」**フィールドに表示されている英数字ストリングです。 **「コピー」**ボタンをクリックしてトークンをクリップボードにコピーします。

   この API トークンを共有しないでください。 この API トークンを持っているどのユーザーも、このユーザーのメトリックに対するフルアクセスを持ちます。

5. IBM Cloud Monitoring インスタンスのエンドポイントはリージョンごとです。 例えば、 IBM Cloud Monitoring インスタンスが us-south に存在する場合、そのエンドポイントは以下のようになります。

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

6. API トークンとエンドポイントの両方が得られたら、POST 要求をフォーマット設定できます。 以下の POST 要求の例には、ユーザーが変更できるすべてのパラメーターが含まれています。 パラメーターは以下のとおりです。

   • Monitor API トークン。
   • IBM Cloud Monitoring インスタンスのエンドポイント。
   • ibm_is_vpn_gateway_name の値 (メトリックを表示する VPN ゲートウェイ名)。

   すべての VPN ゲートウェイについてこのメトリックを表示するには、scope 属性の値を入力しないでください。 例えば、"scope" : "" を使用してください。

   • 結果を表示するメトリック・タイプ。 この例では、ibm_is_vpn_gateway_status を使用しています。
   • from 属性と to 属性で、スキャンの対象にする時間フレームを定義します (エポック時間で設定。単位はマイクロ秒)。
   • sampling 属性と value 属性で、POST 要求で返されるデータの細分度を設定します。

   IBM Cloud Monitoring には大量のデータが保管されているため、特定の細分度レベルを選択することが重要です。IBM Cloud Monitoring が要求ごとに一度に返すことができるデータ・ポイントは 600 個のみです。 したがって、sampling 属性と value 属性は重要です。 これら 2 つの行を要求から除外した場合は、代わりにその期間の合計が返されます。

   from と to で指定した時間範囲が長い場合 (例えば 4 日間など) に、sampling と value で 10 秒を定義すると、10 秒ごとに分割された 4 日分のデータを受け取ることになります。 このサンプルは、大量のデータが返されるので、役に立ちません。 これより長い時間幅を指定することをお勧めします (例えば 10 秒ではなく 1 時間など)。

      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_gateway_name = \"test-001\"",
                "metrics": {
                    "k0": "timestamp",
                    "v1": "ibm_is_vpn_gateway_status"
                },
                "time": {
                    "from": 1589877054000000,
                    "to": 1589877114000000,
                    "sampling": 60000000
                },
                "group": {
                    "by": [
                        {
                           "metric": "k0",
                            "value" : 60000000
                        }
                    ],
                    "aggregations": {
                        "v1": "avg"
                    },
                    "groupAggregations": {
                        "v1": "avg"
                    }
                }
            }
        ]
    }'
   

IBM Cloud Monitoring の UI を使用した VPN for VPC の操作

VPN の UI から、個々の VPN ゲートウェイのメトリックを表示し、IBM Cloud Monitoring ダッシュボードを起動することができます。

1. VPN UIにナビゲートします。

2. IBM Cloud Monitoring メトリックを表示する VPN ゲートウェイ名をクリックし、その**「概要」**ページに移動します。

   **「モニタリングのプレビュー (Monitoring preview)」**パネルに、過去 1 時間のすべてのメトリックの合計が表示されます。

   **「モニタリングの起動」**をクリックすると、VPN ゲートウェイのデフォルトの IBM Cloud Monitoring ダッシュボードが起動します。

3. VPN ゲートウェイの**「モニタリング」**ページを開きます。 時刻範囲内の VPN ゲートウェイのスループットとパケット数がページに表示されます。

   同様に、**「モニタリングの起動」**をクリックして VPN ゲートウェイのデフォルトの IBM Cloud Monitoring ダッシュボードを起動することもできます。