コネクタ

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

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

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

「次へ」を選択します。

コネクタがデータを転送するソース・サービスを指定します。

• ソースの選択: 転送するデータを含むサービスを選択します。
  • ロギング: ロギング・サービスのログ・データを転送します。 ロギングを参照してください。
  • モニタリング: モニタリング・サービスからメトリック・データ・ポイントを移行します。 「モニタリング」を参照してください。
  • キュー: サービスのキューからメッセージを転送します。Queueを参照してください。
  • ストリーミング: ストリーミング・サービスからストリーム・データを転送します。 ストリーミングを参照してください。
• ソースの構成: 選択したソースの値を入力します。

  ロギング

  ノート
  
  問合せコード・エディタを使用してこの情報を入力するか、入力した情報を問合せコードとして表示するには、「拡張モードに切替え」を選択します。

  • コンパートメント名: 必要なログを含むコンパートメント。
  • ログ・グループ: 必要なログを含むログ・グループ。

    ログ入力スキーマについては、LogEntryを参照してください。

  • ログ: 必要なログ。
  • ログ・フィルタ・タスク(オプション): 「ログ」フィールドに表示されるログをフィルタします。

    監査ログ(_Audit)の属性値を指定するには:

    • フィルタ・タイプ: 「属性」を選択します。
    • 属性名: 必要な監査ログ属性を選択します。
    • 属性値: 選択した監査ログ属性の値を指定します。

    監査ログ(_Audit)のイベントを指定するには:

    • フィルタ・タイプ: 「イベント・タイプ」を選択します。
    • サービス名: 必要なイベントを含むサービスを選択します。
    • イベント・タイプ: 目的のイベントを選択します。

    サービス・ログまたはカスタム・ログ(_Auditではない)のプロパティ値を指定するには:

    • プロパティ: 必要なプロパティを選択します。
    • 演算子: プロパティ値のフィルタ設定に使用する演算子を選択します。
    • 値: 必要なプロパティ値を指定します。

    ソース・ログをフィルタリングするためにサポートされている問合せを確認するには、コネクタ・ハブのログ問合せリファレンスを参照してください。

  監視中

  • メトリック・コンパートメント: 必要なメトリックを含むコンパートメントを選択します。
  • ネームスペース: 目的のメトリックを含む1つ以上のメトリック・ネームスペースを選択します。選択したネームスペース内のすべてのメトリックが取得されます。

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

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

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

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

  キュー

  • コンパートメント: 必要なキューを含むコンパートメントを選択します。
  • キュー: 必要なメッセージを含むキューを選択します。
    ノート
    
    コネクタのキューを選択するには、キューを読み取る権限が必要です。IAMポリシー(コネクタ・ハブの保護)を参照してください。

  • チャネル・フィルタ(「メッセージ・フィルタリング」の下) (オプション): キュー内のチャネルからメッセージをフィルタするには、値を入力します。

    たとえば、チャネルIDでメッセージをフィルタするには、チャネルIDを入力します。

    サポートされている値については、GetMessages (キューAPI)のchannelFilterを参照してください。

  ノート
  
  コネクタのターゲットに転送されたメッセージは消費済とみなされます。キュー・サービスの要件を満たすために、コネクタは転送されたメッセージをソース・キューから削除します。詳細は、メッセージの消費を参照してください。

  ストリーミング

  ノート
  
  プライベート・エンドポイント構成がサポートされています。プライベート・エンドポイントを使用するには、ストリームのプライベート・エンドポイントの前提条件を参照してください。

  • コンパートメント: ストリームを含むコンパートメントを選択します。
  • ストリーム・プール: 必要なストリームを含むストリーム・プールを選択します。
    ノート
    
    コネクタのストリーム・プールおよびストリームを選択するには、ストリーム・プールおよびストリームを読み取る権限が必要です。IAMポリシー(コネクタ・ハブの保護)を参照してください。
  • ストリーム: データの受信元のストリームの名前を選択します。
  • 読取り位置: ストリームの読取りを開始するカーソル位置を指定します。
    • 最新: コネクタの作成後にパブリッシュされたメッセージの読取りを開始します。
      • この構成で新しいコネクタを初めて実行すると、コネクタの作成時間からデータが移動します。最初の実行が失敗した場合(ポリシーが欠落している場合など)、解決後、コネクタはコネクタの作成時間からデータを移動するか、作成時間が保存期間外の場合はストリーム内で使用可能な最も古いデータを移動します。たとえば、保存期間が2時間のストリームについて午前10時に作成されたコネクタを考えてみます。失敗した実行が午前11時に解決された場合、コネクタは午前10時からデータを移動します。失敗した実行が午後1時に解決された場合、コネクタはストリーム内で使用可能な最も古いデータを移動します。
      • その後、ストリーム内の次の位置からデータを移動します。後で実行が失敗した場合、解決後、コネクタはストリームの次の位置またはストリーム内の最も古い使用可能なデータから、ストリームの保存期間に応じてデータを移動します。
    • Trim Horizon: ストリーム内で使用可能な最も古いメッセージからの読取りを開始します。
      • この構成で新しいコネクタを初めて実行すると、ストリーム内で使用可能な最も古いデータからデータが移動します。最初の実行が失敗した場合(ポリシーが欠落している場合など)、解決後、コネクタはストリームの保存期間に関係なく、ストリーム内で使用可能な最も古いデータを移動します。
      • その後、ストリーム内の次の位置からデータを移動します。後で実行が失敗した場合、解決後、コネクタはストリームの次の位置またはストリーム内の最も古い使用可能なデータから、ストリームの保存期間に応じてデータを移動します。

「次へ」を選択します。

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

「次へ」を選択します。

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

• ターゲット: データの転送先のサービスを選択します。
  • ファンクション: データをファンクションに送信します。
  • ログ・アナリティクス: データをログ・グループに送信します。
  • モニタリング: メトリック・データ・ポイントをモニタリング・サービスに送信します。
  • 通知: データをトピックに送信します。
  • オブジェクト・ストレージ: データをバケットに送信します。
  • ストリーミング: データをストリームに送信します。
• ターゲットの構成: 選択したターゲットの値を入力します。

  ファンクション

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

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

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

  • コネクタは、ソース・データをバッチでJSONリストとしてフラッシュします。最大バッチ(ペイロード)サイズは6MBです。
  • ファンクションは、1回の呼出しで6MBのデータと同期するように呼び出されます。データが6MBを超えると、コネクタが再びファンクションを呼び出して制限を超えるデータを移動します。このような起動は順次処理されます。
  • ファンクションは最大5分間実行できます。Delivery Detailsを参照してください。
  • Functionsターゲットからコネクタにデータを返さないでください。コネクタ・ハブは、ファンクション・ターゲットから返されたデータを読み取りません。

  ログ・アナリティクス

  • コンパートメント: 必要なログ・グループを含むコンパートメントを選択します。
  • ログ・グループ: 目的のログ・グループを選択してください。
  • ログ・ソース識別子(ストリーミング・ソースの場合のみ): ログ・ソースを選択します。

  モニタリング

  • コンパートメント: 必要なメトリックを含むコンパートメントを選択します。
  • メトリック・ネームスペース: 必要なメトリックが含まれるメトリック・ネームスペースを選択します。既存のネームスペースを選択するか、新しいネームスペースを入力できます。

    新しいネームスペースを入力したら、[Enter]を押して送信します。

    新しいメトリック・ネームスペースの場合は、予約されているoci_接頭辞を使用しないでください。予約済プリフィクスが使用されると、メトリックは取り込まれません。カスタム・メトリックの公開およびPostMetricDataリファレンス(API)を参照してください。

  • メトリック: データの送信先のメトリックの名前を選択します。既存のメトリックを選択するか、新しいメトリックを入力できます。

    新しいメトリック名を入力したら、[Enter]を押して送信します。

    新しいメトリックの場合は、予約済のoci_接頭辞を使用しないでください。予約済プリフィクスが使用されると、メトリックは取り込まれません。カスタム・メトリックの公開およびPostMetricDataリファレンス(API)を参照してください。

  • ディメンションの追加(オプション): ディメンションを構成する場合に選択します。「ディメンションの追加」パネルが開きます。

    ログ・データの最新の6行が、「ソースの構成」で指定したログから取得されます。

    データの送信先ディメンションごとに、名前と値のキー・ペアを指定します。名前はカスタムにすることができます。また、値は静的にするか評価対象のパスにすることができます。ディメンションを使用して、ログ・データがメトリックに移動された後にデータをフィルタ処理します。 ディメンションのユースケースの例は、シナリオ: モニタリング・ターゲットのディメンションの作成を参照してください。

    データにタグ付けするには(静的値)

    • 静的パス: カスタム名(ディメンション名)およびパス(ディメンション・パス)を手動で入力します。たとえば、trafficおよびcustomerと入力します。

  ノート
  
  新しい(カスタム)メトリックの場合、コネクタがソースからモニタリング・サービスにデータを初めて移動するときに、指定されたメトリック・ネームスペースおよびメトリックが作成されます。移動されたデータが存在するかどうかを確認するには、コンソール、CLIまたはAPIを使用して新しいメトリックを問い合せます。カスタム・メトリックの問合せの作成を参照してください。

  メトリックに含まれるもの

  ディメンションの構成で指定したディメンション名/値キー・ペアに加えて、次のディメンションがメトリックに含まれます:

  • connectorId: メトリックが適用されるコネクタのOCID。
  • connectorName: メトリックが適用されるコネクタの名前。
  • connectorSourceType: メトリックを適用するソース・サービス。

  各メトリック・データ・ポイントのタイムスタンプは、対応するログ・メッセージのタイムスタンプです。

  通知

  • コンパートメント: 目的のトピックを含むコンパートメントを選択します。
  • トピック: データの送信先のトピックの名前を選択します。
  • メッセージの書式: 必要なオプションを選択します:
    ノート
    
    「メッセージの書式」オプションは、ロギング・ソースのコネクタでのみ使用できます。これらのオプションは、ファンクション・タスクがあるコネクタでは使用できません。「メッセージ形式」オプションが使用できない場合、メッセージはRAW JSON BLOBとして送信されます。
    • フォーマットされたメッセージの送信: 簡単でわかりやすいレイアウト。

      フォーマットされたメッセージに対してサポートされているサブスクリプション・プロトコルとメッセージ・タイプを確認するには、わかりやすいフォーマットを参照してください。

    • RAWメッセージの送信: RAW JSON BLOB。

  通知ターゲットの考慮事項:

  • Notificationsのターゲットの最大メッセージ・サイズは128KBです。最大サイズを超えるメッセージは削除されます。
  • SMSメッセージでは、特定のコネクタ構成の場合に予期しない結果が生成されます。この問題は、指定されたコネクタ構成でSMSサブスクリプションを含むトピックに限定されます。詳細は、1つの通知に対する複数のSMSメッセージを参照してください。

  オブジェクト・ストレージ

  • コンパートメント: 必要なバケットを含むコンパートメントを選択します。
  • バケット: データの送信先のバケットの名前を選択します。
  • オブジェクト名接頭辞: オプションで接頭辞値を入力します。
  • バッチ・オプションの表示: このリンクを選択し、オプションでバッチ・サイズ(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ソースから移動されるデータの形式: 各オブジェクトは個別のメッセージとして書き込まれます。

「次へ」を選択します。

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

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