シナリオ: オブジェクト・ストレージへのメトリックの送信

コネクタ・ハブを使用して、メトリックをオブジェクト・ストレージのバケットに送信する方法について学習します。

必要なIAMポリシー

管理者グループのメンバーであれば、このシナリオを完了するために必要なアクセス権をすでに持っています。それ以外の場合は、指定したコンパートメントのメトリックに対する読取りアクセス権が必要です。

モニタリング・ソースでコネクタを作成するためのワークフローには、選択したコンパートメントでモニタリングから読取りを行うためのデフォルト・ポリシーが含まれます。ポリシーを初めて使用する場合は、ポリシーの開始および共通ポリシーを参照してください。

目標

このシナリオの目標は、コンピュート・インスタンスおよびブロック・ボリュームのメトリック・データをオブジェクト・ストレージ・バケットにアーカイブすることです。このシナリオでは、リソースは2つのコンパートメントにあるため、両方のコンパートメントでメトリックを選択します。

このシナリオの設定

このシナリオの設定には、コンピュート・インスタンスおよびブロック・ボリューム・メトリック(oci_computeagentおよびoci_blockstoreメトリック・ネームスペース)をバケットに移動するためのコネクタの作成が含まれます。これらのネームスペースのすべてのメトリックが含まれます。

これらのタスクは、Oracle Cloud Infrastructureコンソール、CLIまたはAPIで完了できます。

    1. 「コネクタ」リスト・ページで、「コネクタの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、コネクタのリストを参照してください。
    2. 「コネクタの作成」ページで、新しいコネクタのわかりやすい名前と説明(オプション)を入力します。機密情報を入力しないでください。
      例: 「バケットへのメトリック」
    3. リソース・コンパートメントで、新しいコネクタを格納するコンパートメントを選択します。
    4. 「コネクタの構成」で、ログ・データをメトリックに移動するソース・サービスおよびターゲット・サービスを選択します:
      • ソース: モニタリング
      • ターゲット: オブジェクト・ストレージ
    5. 「ソースの構成」で、各コンパートメントのコンピュート・インスタンスおよびブロック・ボリューム・メトリックを選択します:
      1. メトリック・コンパートメント: メトリックを使用するコンピュート・インスタンスおよびブロック・ボリュームを含む最初のコンパートメント。

      2. ネームスペース: oci_computeagentおよびoci_blockstoreを選択します。

      3. 「+別のコンパートメント」を選択して、2番目のコンパートメントを追加します。

      4. メトリック・コンパートメント: メトリックを使用するコンピュート・インスタンスおよびブロック・ボリュームを含む2番目のコンパートメント。

      5. ネームスペース: oci_computeagentおよびoci_blockstoreを選択します。

    6. オプションのタスクをスキップします(タスクの構成)。
    7. 「ターゲットの構成」で、メトリックを移動するバケットを選択します:
      • バケットを含むコンパートメントを選択します。
      • 目的のバケットを選択します。
    8. デフォルト・ポリシーを受け入れます。各デフォルト・ポリシーに用意されている「作成」リンクを選択します。
    9. 「作成」を選択します。

    作成プロセスが開始され、その進行状況が表示されます。完了すると、コネクタの詳細ページが開きます。新しいコネクタは、選択したバケットへのメトリックの移動をすぐに開始します。メトリックがバケット内のオブジェクトに含まれます。

    1. コネクタのモニタリング・ソースを定義します: source.jsonという名前のファイルを保存します。

      source.jsonファイルの例
      {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      }
    2. コネクタのオブジェクト・ストレージ・ターゲットを定義します: target.jsonという名前のファイルを保存します。

      target.jsonファイルの例
      {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    3. oci sch service-connector createコマンドを使用して、コネクタを作成します:

      コネクタを作成するためのコマンドの例
      oci sch service-connector create
       --compartment-id <compartment_OCID>
       --display-name "Metrics to Bucket"
       --source file://source.json
       --target file://target.json

      CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

      トラブルシューティングのヘルプは、コネクタのトラブルシューティングおよび通知のトラブルシューティングを参照してください。

    CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

  • コネクタを作成するには、CreateServiceConnector操作を使用します。

    CreateServiceConnectorリクエストの例
    POST /20200909/serviceConnectors
    Host: service-connector-hub.us-phoenix-1.oraclecloud.com
    <authorization and other headers>
    {
      "compartmentId": "<compartment_OCID>",
      "displayName": "Metrics to Bucket",
      "source": {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      },
      "target": {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    }

次の作業

コンソールでオブジェクトを表示するには、コネクタの詳細ページに表示されるバケットの名前を選択します。(バケット名を表示するには下にスクロールすることが必要な場合があります。)

オブジェクトのダウンロードの詳細は、オブジェクト・ストレージ・オブジェクトのダウンロードを参照してください。

バケットにメトリックが存在しない場合は、移動中のデータがないのトラブルシューティング情報を参照してください。トラブルシューティングの一般的なヘルプは、コネクタのトラブルシューティングを参照してください。