シナリオ: ログ・データの警告

この項では、CLIを使用したコネクタ、トピック、サブスクリプションおよびアラームの作成手順を説明します。

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

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

   oci sch service-connector create --display-name
   "<display_name>" --compartment-id <compartment_OCID> --source [<source_in_JSON>] --tasks [<tasks_in_JSON>] --target [<targets_in_JSON>]

2. トピックを作成します: コマンド・プロンプトを開き、oci ons topic createコマンドを実行します:

   oci ons topic create --name "Alarm Topic" --compartment-id "<compartment-ocid>"

3. このトピックに、電子メール・アドレスを参照するサブスクリプションを追加します。コマンド・プロンプトを開き、oci ons subscription createコマンドを実行します:

   oci ons subscription create --compartment-id "<compartment-ocid>" --topic-id "<topic-ocid>" --protocol "EMAIL" --subscription-endpoint "john.smith@example.com"

4. エラーのしきい値を定義して、このトピックを宛先として使用するアラームを作成します: コマンド・プロンプトを開き、oci monitoring alarm createコマンドを実行します:

   oci monitoring alarm create --display-name "My Alarm" --compartment-id "<compartment-ocid>" --metric-compartment-id "<compartment-ocid>" --namespace "oci_computeagent" --query-text "<yourmetric>[1m].count() > 0" --severity "INFO" --destinations "<topic-ocid>" --is-enabled true

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

この項では、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>",
     "description": "My connector description",
     "displayName": "My Connector",
     "source": {
       "kind": "logging",
       "logSources": [
         {
           "compartmentId": "<compartment_OCID>",
           "logGroupId": "<log_group_OCID>",
           "logId": "<log_OCID>"
         }
       ]
     },
     "target": {
       "compartmentId": "<compartment_OCID>",
       "kind": "metrics",
       "metric": "<yourmetric>",
       "metricNamespace": "<yournamespace>"
     },
     "tasks": [
       {
         "condition": "data.action='REJECT'",
         "kind": "logRule"
       }
     ]
     }
   }

2. CreateTopic: トピックを作成します。

   CreateTopicリクエストの例

   POST /20181201/topics
   Host: notification.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "name": "Alarm Topic",
     "compartmentId": "<compartment_OCID>"
   }

3. CreateSubscription: このトピックに、電子メール・アドレスを参照するサブスクリプションを追加します。

   CreateSubscriptionリクエストの例: 電子メール

   POST /20181201/subscriptions
   Host: notification.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "topicId": "<topic_OCID>",
     "compartmentId": "<compartment_OCID>",
     "protocol": "EMAIL",
     "endpoint": "john.smith@example.com"
   }

4. CreateAlarm: メモリーしきい値を定義して、このトピックを参照するアラームを作成します。

   CreateAlarmリクエストの例

   POST /20180401/alarms
   Host: telemetry.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "displayName": "My Alarm",
     "compartmentId": "<compartment_OCID>",
     "metricCompartmentId": "<compartment_OCID>",
     "namespace": "<yournamespace>",
     "query": "<yourmetric>[1m].count() > 0",
     "severity": "INFO",
     "destinations":
     [
       "<topic_OCID>"
     ],
     "isEnabled": true
   }

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