シナリオ: オブジェクト・ストレージへのメトリックの送信
コネクタ・ハブを使用して、メトリックをオブジェクト・ストレージのバケットに送信する方法について学習します。
必要なIAMポリシー
管理者グループのメンバーであれば、このシナリオを完了するために必要なアクセス権をすでに持っています。それ以外の場合は、指定したコンパートメントのメトリックに対する読取りアクセス権が必要です。
モニタリング・ソースを使用してコネクタを作成するためのワークフローには、選択したコンパートメントでモニタリングから読み取るためのデフォルト・ポリシーが含まれます。ポリシーを初めて使用する場合は、IAMポリシーの概要を参照してください。
目標
このシナリオの目標は、コンピュート・インスタンスおよびブロック・ボリュームのメトリック・データをオブジェクト・ストレージ・バケットにアーカイブすることです。このシナリオでは、リソースは2つのコンパートメントにあるため、両方のコンパートメントでメトリックを選択します。
このシナリオの設定
このシナリオの設定には、コンピュート・インスタンスおよびブロック・ボリューム・メトリック(oci_computeagentおよびoci_blockstoreメトリック・ネームスペース)をバケットに移動するためのコネクタの作成が含まれます。これらのネームスペースのすべてのメトリックが含まれます。
これらのタスクは、Oracle Cloud Infrastructureコンソール、CLIまたはAPIで完了できます。
トラブルシューティングのヘルプは、コネクタのトラブルシューティングおよび通知のトラブルシューティングを参照してください。
「コネクタ」リスト・ページで、「コネクタの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、コネクタのリストを参照してください。
1. 基本的なコネクタ情報
識別情報の入力
- コネクタ名: 新しいコネクタのわかりやすい名前とオプションの説明を入力します。機密情報を入力しないでください。
- コンパートメントの選択: 新しいコネクタを格納するコンパートメントを選択します。
「次へ」を選択します。
2. コネクタ・ソースの構成
データを転送するコネクタのソース・メトリックを指定します。
- ソースの選択: 「モニタリング」を選択します。
- ソースの構成: 各コンパートメントのコンピュート・インスタンスおよびブロック・ボリューム・メトリックを選択します。
- メトリック・コンパートメント: メトリックの対象となるコンピュート・インスタンスおよびブロック・ボリュームを含む最初のコンパートメント。
- ネームスペース:
oci_computeagentおよびoci_blockstoreを選択します。 - 「+別のコンパートメント」を選択して、2番目のコンパートメントを追加します。
- メトリック・コンパートメント: メトリックの対象となるコンピュート・インスタンスおよびブロック・ボリュームを含む2番目のコンパートメント。
- ネームスペース:
oci_computeagentおよびoci_blockstoreを選択します。
- ポリシーの作成: 入力したソース構成に指定されたデフォルト・ポリシーを受け入れる場合に選択します。
「次へ」を選択します。
3. コネクタ・タスクの構成
「次へ」を選択します(このセクションはスキップします)。
4. コネクタ・ターゲットの構成
データの送信先のバケットを指定します。
- ターゲット: 「オブジェクト・ストレージ」を選択します。
- ターゲットの構成: データの送信先のコンパートメントおよびバケットを選択します。
- ポリシーの作成: 入力したターゲット構成に指定したデフォルト・ポリシーを受け入れる場合に選択します。
「次へ」を選択します。
コネクタ・プレビュー
コネクタ構成を確認し、「作成」を選択します。
作成プロセスが開始され、その進行状況が表示されます。完了すると、コネクタの詳細ページが開きます。
-
コネクタのモニタリング・ソースを定義します:
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" } } ] } } ] } -
コネクタのオブジェクト・ストレージ・ターゲットを定義します:
target.jsonという名前のファイルを保存します。target.jsonファイルの例{ "kind": "objectStorage", "bucketName": "<bucket_name>", "objectNamePrefix": "<prefix>" } -
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.jsonCLIコマンドのパラメータおよび値の完全なリストは、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>" } }
次の作業
コンソールでオブジェクトを表示するには、コネクタの詳細ページに表示されるバケットの名前を選択します。(バケット名を表示するには下にスクロールすることが必要な場合があります。)
オブジェクトのダウンロードの詳細は、オブジェクト・ストレージ・オブジェクトのダウンロードを参照してください。
バケットにメトリックが存在しない場合は、「データが移動されていません」のトラブルシューティング情報を参照してください。トラブルシューティングに関する一般的なヘルプは、Troubleshooting Connectorsを参照してください。