モニタリング・ソースとのコネクタの作成

コネクタ・ハブでコネクタを作成し、メトリック・データ・ポイントをモニタリング・サービスからターゲット・サービスに転送します。

モニタリング・サービスの詳細は、モニタリングを参照してください。

モニタリング・ソースおよび(オプションの)ファンクション・タスクで定義されたコネクタでは、ファンクション、オブジェクト・ストレージおよびストリーミングのターゲットがサポートされます。コネクタ・ハブ・ワークフローの例は、「コネクタ・ハブの概要」を参照してください。モニタリングをソースとして使用するコネクタの例は、シナリオ: オブジェクト・ストレージへのメトリックの送信を参照してください。

保持期間: ソースの監視

コネクタ・ハブのモニタリング・ソースの保持期間は24時間です。搬送の詳細は、「搬送詳細」を参照してください。

モニタリングから受信したデータの形式

Monitoringから受信したメトリック・データはRAWです。(メトリック・チャートに表示される集計データと対比してください。)

Monitoringからのレスポンスには、通常、複数のメトリック・データ・ポイントが含まれます。次のレスポンスの省略された例は、コンピュート・インスタンスから読み取られたディスク・バイトの2つのRAWメトリック・データ・ポイントを示しています:
[
  {
    "namespace":"oci_computeagent",
    "compartmentId":"ocid1.tenancy.oc1..exampleuniqueID",
    "name":"DiskBytesRead",
    "dimensions":{
      "resourceId":"ocid1.instance.region1.phx.exampleuniqueID"
    },
    "metadata":{
      "unit":"bytes"
    }
  },
  "datapoints":[
    {
      "timestamp":"2022-03-10T22:19:00Z",
      "value":10.4
    },
    {
      "timestamp":"2022-03-10T22:20:00Z",
      "value":11.3
    }
  ]
]

ターゲットでのデータの形式は、ターゲット・タイプによって異なります。

  • 「コネクタ」リスト・ページで、「コネクタの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、コネクタのリストを参照してください。

    ノート

    構成にポリシーが必要な場合は、デフォルトのポリシーが提供されます。デフォルト・ポリシーを受け入れるには、指定された「ポリシーの作成」リンクを選択します。

    デフォルト・ポリシーは、このコネクタがソース、タスクおよびターゲット・サービスにアクセスするために必要な認可のために提供されます。

    この認可は、このようなデフォルト・ポリシーまたはグループベースのポリシーから取得できます。デフォルト・ポリシーは、コンソールを使用してコネクタを作成または編集する際に必ず提供されます。唯一の例外は、IAMに正確なポリシーがすでに存在する場合です。このケースではデフォルト・ポリシーは提供されません。この認可要件の詳細は、認証と認可を参照してください。

    • デフォルト・ポリシーを受け入れる権限がない場合は、管理者に連絡してください。
    • 自動的に作成されたポリシーは、コネクタが削除されてもそのままです。ベスト・プラクティスとしては、コネクタを削除するときに関連するポリシーを削除してください。

    新しく作成したポリシーを確認するには、関連付けられたビュー・リンクを選択します。

    1. 基本的なコネクタ情報

    識別情報およびオプションのログとタグを入力します。

    • コネクタ名: 新しいコネクタのわかりやすい名前とオプションの説明を入力します。機密情報を入力しないでください。
    • コンパートメントの選択: 新しいコネクタを格納するコンパートメントを選択します。
    • 説明(オプション): コネクタの説明を入力します。
    • ログの有効化(オプション): 新しいコネクタのサービス・ログを有効にし、次の情報を指定する場合に選択します。
      • カテゴリ (デフォルト値: 実行ログ)
      • コンパートメント: コネクタのサービス・ログを格納するコンパートメントを選択します。
      • ログ・グループ: サービス・ログを格納するログ・グループ(コンパートメント別)を選択します。新しいログ・グループを作成するには、「新規グループの作成」を選択し、名前を入力します。
      • Log name (オプション): ログの名前を入力します。
      • 拡張オプションの表示:
        • レガシー・アーカイブ・ログの有効化(オプション): レガシー・ログ・アーカイブでは、コンパートメントにバケットが自動的に作成され、ログのコピーがアーカイブされます。
        • ログの保存(オプション): サービス・ログを保持する期間を指定します(デフォルト: 30日)。
      • タグ(オプション): コネクタにタグを追加するには、表示されるオプションを選択します。
        • タグ
        • タグの追加(「拡張オプションの表示」の下)

        リソースを作成するアクセス許可がある場合、そのリソースにフリーフォーム・タグを適用するアクセス許可もあります。定義済タグを適用するには、タグネームスペースを使用する権限を持つ必要があります。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。

    「次へ」を選択します。

    2. コネクタ・ソースの構成

    データを転送するコネクタのソース・メトリックを指定します。

    • ソースの選択: 「モニタリング」を選択します。
    • ソースの構成: ソース・メトリックを選択します。
      • メトリック・コンパートメント: 必要なメトリックを含むコンパートメントを選択します。
      • ネームスペース: 必要なメトリックを含む1つ以上のメトリック・ネームスペースを選択します。選択したネームスペースのすべてのメトリックが取得されます。

        ネームスペースは"oci_"で始まる必要があります。例: oci_computeagent。

      • 別のコンパートメントからメトリック・ネームスペースを追加するには、「+別のコンパートメント」を選択します。

        Monitoringソース当たりのメトリック・コンパートメントの最大数は5です。(すべてのメトリック・コンパートメントにわたる)モニタリング・ソース当たりのネームスペースの最大数は50です。次に、この最大値内に残る単一ソース内のコンパートメント・セットの例を示します:

        • それぞれ10個のネームスペースを持つ5つのメトリック・コンパートメント
        • ネームスペースの数が異なる3つのメトリック・コンパートメント(20、20、10)
        • 50ネームスペースの1つのメトリック・コンパートメント

    「次へ」を選択します。

    3. コネクタ・タスクの構成

    オプションで、ファンクション・サービスを使用してソースからのデータを処理するようにファンクション・タスクを構成します。

    • コンパートメント: 必要なファンクションを含むコンパートメントを選択します。
    • ファンクション・アプリケーション: 必要なファンクションが含まれるファンクション・アプリケーションの名前を選択します。
    • ファンクション: ソースから取得したデータの処理に使用するファンクションの名前を選択します。

      タスクとしてコネクタによって使用される場合は、次のいずれかのレスポンスを返すようにファンクションを構成する必要があります:

      • JSONエントリのリスト(レスポンス・ヘッダーContent-Type=application/jsonを設定する必要があります)
      • 単一のJSONエントリ(レスポンス・ヘッダーContent-Type=application/jsonを設定する必要があります)
      • 単一のバイナリ・オブジェクト(レスポンス・ヘッダーContent-Type=application/octet-streamを設定する必要があります)
    • 「追加オプションの表示」(オプション)
      • バッチ・オプション(オプション): 関数に送信されるデータの各バッチの制限を指定します。
        • 自動設定を使用
        • 手動設定の使用: バッチ・サイズ制限(KB)およびバッチ時間制限(秒)の値を指定します。

    ファンクション・タスクの考慮事項:

    • コネクタ・ハブは、ファンクション・タスクの出力を分析しません。ファンクション・タスクの出力は、そのままターゲットに書き込まれます。たとえば、ファンクション・タスクで通知ターゲットを使用する場合、すべてのメッセージはRAW JSON BLOBとして送信されます。
    • ファンクションは、1回の呼出しで6MBのデータと同期するように呼び出されます。データが6MBを超えると、コネクタが再びファンクションを呼び出して制限を超えるデータを移動します。このような呼出しは順次処理されます。
    • ファンクションは最大5分間実行できます。Delivery Detailsを参照してください。
    • 関数タスクはスカラー関数に制限されます。

    「次へ」を選択します。

    4. コネクタ・ターゲットの構成

    データの送信先のターゲット・サービスを指定します。

    • ターゲット: データの転送先のサービスを選択します。
      • ファンクション: メトリック・データ・ポイントをファンクションに送信します。
      • オブジェクト・ストレージ: メトリック・データ・ポイントをバケットに送信します。
      • ストリーミング: メトリック・データ・ポイントをストリームに送信します。
    • ターゲットの構成: 選択したターゲットの値を入力します。
      ファンクション
      • コンパートメント: 必要なファンクションを含むコンパートメントを選択します。
      • ファンクション・アプリケーション: 必要なファンクションを含むファンクション・アプリケーションの名前を選択します。
      • ファンクション: データの送信先のファンクションの名前を選択します。
      • 追加オプションの表示(オプション): このリンクを選択し、関数に送信されるデータのバッチごとに制限を指定します。手動設定を使用するには、バッチ・サイズ制限(KBまたはメッセージ数)およびバッチ時間制限(秒)の値を指定します。

        たとえば、5,000KBまたは10メッセージを選択して、バッチ・サイズを制限します。バッチ時間制限の例は5秒です。

      ファンクションのターゲットに関する考慮事項:

      • コネクタはソース・データをJSONリストとしてバッチでフラッシュします。最大バッチ(ペイロード)サイズは6MBです。
      • ファンクションは、1回の呼出しで6MBのデータと同期するように呼び出されます。データが6MBを超えると、コネクタが再びファンクションを呼び出して制限を超えるデータを移動します。このような呼出しは順次処理されます。
      • ファンクションは最大5分間実行できます。Delivery Detailsを参照してください。
      • Functionsターゲットからコネクタにデータを返さないでください。コネクタ・ハブは、ファンクション・ターゲットから返されたデータを読み取りません。
      オブジェクト・ストレージ
      • コンパートメント: 目的のバケットを含むコンパートメントを選択します。
      • バケット: データの送信先のバケットの名前を選択します。
      • オブジェクト名接頭辞: オプションで接頭辞値を入力します。
      • バッチ・オプションの表示: このリンクを選択し、オプションでバッチ・サイズ(MB)およびバッチ時間(ミリ秒)の値を入力します。フィールドには、「バッチ・サイズ」および「バッチ時間」というラベルが付いています。

      オブジェクト・ストレージ・ターゲットに関する考慮事項:

      • バッチ・ロールオーバーの詳細:

        • バッチ・ロールオーバー・サイズ: 100MB
        • バッチ・ロールオーバー時間: 7分
      • オブジェクト・ストレージに保存されるファイルは、gzipを使用して圧縮されます。

      • モニタリング・ソースから移動されたデータの形式: オブジェクト。コネクタは、メトリック・ネームスペース別のモニタリングからソース・データをパーティション化し、各グループ(ネームスペース)のデータをオブジェクトに書き込みます。各オブジェクト名には次の要素が含まれます。

        <object_name_prefix>/<service_connector_ocid>/<metric_compartment_ocid>/<metric_namespace>/<data_start_timestamp>_<data_end_timestamp>.<sequence_number>.<file_type>.gz

        オブジェクト内では、データ・ポイントの各セットが新しい行に追加されます。

      ストリーミング
      ノート

      コネクタのストリーム・プールおよびストリームを選択するには、ストリーム・プールおよびストリームを読み取るための認可が必要です。IAMポリシー(コネクタ・ハブの保護)を参照してください。プライベート・エンドポイント構成がサポートされています。プライベート・エンドポイントを使用するには、Streamsのプライベート・エンドポイントの前提条件を参照してください。
      • コンパートメント: 必要なストリームを含むコンパートメントを選択します。
      • ストリーム: データの送信先のストリームの名前を選択します。

      ストリーミング・ターゲットの考慮事項:

      • Monitoringソースから移動されるデータの形式: 各オブジェクトは個別のメッセージとして書き込まれます。

    「次へ」を選択します。

    コネクタ・プレビュー

    コネクタ構成を確認し、「作成」を選択します。

    作成プロセスが開始され、その進行状況が表示されます。完了すると、コネクタの詳細ページが開きます。

  • モニタリング・ソースを使用してコネクタを作成するには、oci sch service-connector createコマンドと必要なパラメータを使用します:

    oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<metrics_source_in_JSON>] --target [<target_in_JSON>]

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

  • CreateServiceConnector操作を実行してコネクタを作成します。

    モニタリング・ソースを含むコネクタを作成するには、リクエスト(CreateServiceConnectorDetails)のsourceにモニタリングの詳細を移入します。例については、MonitoringSourceDetailsを参照してください。

新規コネクタによるデータの移動の確認

コネクタを作成したら、データが移動していることを確認します。

  • コネクタでデータ・フローの詳細を取得するためのログの有効化。
  • ターゲット・サービスで予想される結果を確認します。

データが移動されていることを確認すると、自動非アクティブ化を回避できます。これは、コネクタに長時間障害が発生した場合に発生します。