Scenario: allarme sui dati di log

Se si è membri del gruppo Administrators, si dispone già dell'accesso necessario per eseguire questo scenario. In caso contrario, è necessario accedere a Monitoraggio e Notifiche.

Il workflow per la creazione del connettore include un criterio predefinito quando necessario per fornire l'autorizzazione per la scrittura nel servizio di destinazione. Per informazioni nuove sui criteri, vedere Panoramica dei criteri IAM.

L'impostazione è semplice nella console. In alternativa, puoi utilizzare l'interfaccia CLI o l'API di Oracle Cloud Infrastructure, che ti consente di eseguire manualmente le singole operazioni.

In questa sezione viene descritto come creare un connettore e un allarme utilizzando la console e quindi aggiornare l'argomento creato con l'allarme.

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.

In questa sezione viene descritto come creare il connettore, l'argomento, le sottoscrizioni e l'allarme utilizzando l'interfaccia CLI.

Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

1. Creare un connettore: aprire un prompt dei comandi ed eseguire il comando 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. Creare un argomento: aprire un prompt dei comandi ed eseguire il comando oci ons topic create: 

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

3. A questo argomento aggiungere una sottoscrizione che faccia riferimento al proprio indirizzo e-mail. Aprire un prompt dei comandi ed eseguire il comando 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. Creare un allarme che definisca la soglia di errore e faccia riferimento a questo argomento come destinazione: aprire un prompt dei comandi ed eseguire il comando 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

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.

In questa sezione viene descritto come creare il connettore, l'argomento, la sottoscrizione e l'allarme utilizzando l'API.

Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

Utilizzare le operazioni descritte di seguito.

1. CreateServiceConnector: crea un connettore.

   Esempio di richiesta 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: creare un argomento.

   Esempio di richiesta CreateTopic

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

3. CreateSubscription: a questo argomento, aggiungere una sottoscrizione che faccia riferimento al proprio indirizzo e-mail.

   Esempio di richiesta CreateSubscription: e-mail

   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: crea un allarme che definisce la soglia di memoria e fa riferimento a questo argomento.

   Esempio di richiesta 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
   }

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.