シナリオ: モニタリング・ターゲットのディメンションの作成

管理者グループのメンバーであれば、このシナリオを完了するために必要なアクセス権をすでに持っています。それ以外の場合は、モニタリングへのアクセス権が必要です。

コネクタを作成するワークフローには、ターゲット・サービスへの書込み権限を提供するために必要なデフォルト・ポリシーが含まれます。ポリシーを初めて使用する場合は、ポリシーの開始および共通ポリシーを参照してください。

このトピックでは、このシナリオの目標について説明します。

このシナリオの目標は、オブジェクト・ストレージ・バケットの更新イベントをフィルタ処理することです。たとえば、バケットをパブリック・アクセスに変更した更新を探します。パブリック・バケットを検出すると、機密情報の漏洩を防ぐことに役立ちます。このシナリオでは、パブリック・アクセス・タイプの他に、バケット名、コンパートメント名、可用性ドメイン、バージョン管理ステータスおよび静的値のフィルタを設定します。

このトピックでは、このシナリオの設定に関連するタスクについて説明します。

このシナリオでは、コネクタ・ハブ・サービスを使用してログからメトリックを作成します。このシナリオの設定には、次のタスクが含まれます:

• ログをLoggingからMonitoring内のディメンションを含むカスタム・メトリックに移動するコネクタを作成します。

  • ログ・データ: 監査ログ(_Auditログ・グループ)のバケット - 更新イベント

    ノート
    
    このシナリオでは_Auditログ・グループおよびバケット更新イベントを使用しますが、テナンシで使用可能なすべてのログに対して同様のアプローチを使用できます。

  • メトリック・ネームスペース: bucket_events

  • メトリック名: update

  • 静的値 buckets-from-connector (ディメンション名: mytags)

  • パス・ディメンションを使用して抽出される値:

    ノート
    
    

    新しいディメンション値ごとに、新しいメトリック・ストリームが作成されます。スロットルが発生する可能性がある一意のメトリック・ストリームの生成が多すぎないように、ディメンションからGUIDまたはUUID (コンパートメントOCIDsなど)を除外することをお薦めします。

    パス・プロパティ(ディメンション名)	値
    bucketName	logContent.data.additionalDetails.bucketName
    compartmentName	logContent.data.compartmentName
    availabilityDomain	logContent.data.availabilityDomain
    publicAccessType	logContent.data.additionalDetails.publicAccessType
    versioning	logContent.data.additionalDetails.versioning

• 移動されたデータをディメンション(静的値および抽出された値)でフィルタ処理します。

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

このトピックでは、コンソールを使用してシナリオを設定する方法について説明します。

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

このトピックでは、CLIを使用して、コネクタを作成し、移動したデータをフィルタ処理する方法について説明します。

APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。

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

   source.jsonファイルの例

   {
     "kind": "logging",
     "logSources": [
       {
         "compartmentId": "<compartment_OCID>",
           "logGroupId": "_Audit",
           "logId": null
       }
     ]
   }

2. コネクタのターゲット(メトリックとディメンション)を定義します: target.jsonという名前のファイルを保存します。

   target.jsonファイルの例

   {
     "kind": "monitoring",
     "compartmentId": "<compartment_OCID>",
     "metricNamespace": "bucket_events",
     "metric": "update",
     "dimensions": [
       {"name": "mytags", "dimensionValue": {"kind": "static", "value": "buckets-from-connector"}},
       {"name": "bucketName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.bucketName"}},
       {"name": "compartmentName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.compartmentName"}},
       {"name": "availabilityDomain", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.availabilityDomain"}},
       {"name": "publicAccessType", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.publicAccessType"}},
       {"name": "versioning", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.versioning"}}
     ]
   }

3. コネクタを作成します: コマンド・プロンプトを開き、oci sch service-connector createコマンドを実行します:

   コネクタを作成するためのコマンドの例

   oci sch service-connector create
    --compartment-id <compartment_OCID>
    --display-name "Bucket - Update"
    --source file://source.json
    --target file://target.json

4. カスタム・ディメンションを使用してメトリック・データを問い合せます: コマンド・プロンプトを開き、oci monitoring metric-data summarize-metrics-dataコマンドを実行します:

   カスタム・ディメンションを使用してメトリック・データを問い合せるコマンドの例

   oci monitoring metric-data summarize-metrics-data
    --compartment-id <compartment_OCID>
    --namespace bucket_events
    --query-text update[1m]{mytags = "buckets-from-connector", bucketName = "bucket-20210722-1148", coompartmentName = "development", availabilityDomain = "PHX-AD-3", publicAccessType = "ObjectRead", versioning = "Enabled"}.count()

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

このトピックでは、APIを使用して、コネクタを作成し、移動したデータをフィルタ処理する方法について説明します。

APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。

次の操作を使用します:

1. CreateServiceConnector: コネクタを作成します。

   CreateServiceConnectorリクエストの例

   POST /20200909/serviceConnectors
   Host: service-connector-hub.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "compartmentId": "<compartment_OCID>",
     "displayName": "Bucket - Update",
     "source": {
       "kind": "logging",
       "logSources": [
         {
           "compartmentId": "<compartment_OCID>",
           "logGroupId": "_Audit",
           "logId": null
         }
       ]
     },
     "target": {
       "compartmentId": "<compartment_OCID>",
       "dimensions": [
         {"name": "mytags", "dimensionValue": {"kind": "static", "value": "buckets-from-connector"}},
         {"name": "bucketName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.bucketName"}},
         {"name": "compartmentName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.compartmentName"}},
         {"name": "availabilityDomain", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.availabilityDomain"}},
         {"name": "publicAccessType", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.publicAccessType"}},
         {"name": "versioning", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.versioning"}}
       ]
       "kind": "monitoring",
       "metric": "update",
       "metricNamespace": "bucket_events"
     }
   }

2. SummarizeMetricsData: ディメンションによってメトリック・データを問い合せます。

   SummarizeMetricsDataリクエストの例

   POST /20180401/metrics/actions/summarizeMetricsData?compartmentId=<compartment_OCID>
   Host: telemetry.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "namespace": "bucket_events",
     "query": "update[1m]{mytags = "buckets-from-connector", bucketName = "bucket-20210722-1148", coompartmentName = "development", availabilityDomain = "PHX-AD-3", publicAccessType = "ObjectRead", versioning = "Enabled"}.count()"
   }

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