Scénario : Alarme sur les données de journal

Si vous êtes membre du groupe Administrateurs, vous avez déjà l'accès requis pour exécuter ce scénario. Sinon, vous devez avoir besoin d'accéder aux services de surveillance et d' avis .

Le flux de travail de création du connecteur inclut une politique par défaut, si nécessaire, afin de fournir l'autorisation d'écriture sur le service cible. Pour en savoir plus sur les politiques, voir Aperçu des politiques IAM.

La configuration est très simple dans la console. Vous pouvez également utiliser l'interface de ligne de commande ou l'API Oracle Cloud Infrastructure, qui vous permettent d'exécuter vous-même les opérations individuelles.

Cette section décrit la création d'un connecteur et d'une alerte à l'aide de la console, puis la mise à jour du sujet créé avec l'alarme.

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.

Cette section décrit la création du connecteur, du sujet, des abonnements et de l'alarme au moyen de l'interface de ligne de commande.

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

1. Créez un connecteur : Ouvrez une invite de commande et exécutez la commande 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. Créez un sujet : Ouvrez une invite de commande et exécutez la commande oci ons topic create : 

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

3. Ajoutez à ce sujet un abonnement référençant votre adresse de courriel. Ouvrez une invite de commande et exécutez la commande 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. Créez une alarme qui définit le seuil d'erreur et référence ce sujet en tant que destination : Ouvrez une invite de commande et exécutez la commande 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

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.

Cette section décrit la création du connecteur, du sujet, de l'abonnement et de l'alarme au moyen de l'API.

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

Utilisez les opérations suivantes :

1. CreateServiceConnector : Créez un connecteur.

   Exemple de demande 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 : Créez un sujet.

   Exemple de demande CreateTopic

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

3. CreateSubscription : Ajoutez à ce sujet un abonnement référençant votre adresse de courriel.

   Exemple de demande CreateSubscription : Courriel

   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 : Créez une alarme qui définit le seuil de mémoire et référencez ce sujet.

   Exemple de demande 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
   }

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.