Escenario: alarma para datos de log

Si es miembro del grupo Administradores, ya tendrá el acceso necesario para ejecutar este escenario. De lo contrario, necesita acceso a los servicios Monitoring y Notifications .

El flujo de trabajo para crear el conector incluye una política por defecto cuando es necesario para proporcionar permiso para escribir en el servicio de destino. Si no conoce las políticas, consulte Visión general de las políticas de IAM.

La configuración resulta sencilla en la consola. También puede utilizar la CLI o API de Oracle Cloud Infrastructure, que permite ejecutar las operaciones individuales.

En esta sección se describe la creación de un conector y una alarma mediante la consola y la actualización posterior del tema creado con la alarma.

Para obtener ayuda con el proceso de resolución de problemas, consulte Solución del problema de los conectores y Solución del problema de Notifications.

En esta sección se describe la creación del conector, el tema, las suscripciones y la alarma mediante la CLI.

Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte la documentación de la API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Los SDK y la CLI.

1. Cree un conector: abra un símbolo del sistema y ejecute el 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. Cree un tema: abra un símbolo del sistema y ejecute el comando oci ons topic create:

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

3. En este tema, agregue una suscripción que haga referencia a su dirección de correo electrónico. Abra un símbolo del sistema y ejecute el 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. Cree una alarma que defina el umbral de error y que haga referencia a este tema como el destino: abra un símbolo del sistema y ejecute el 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

Para obtener ayuda con el proceso de resolución de problemas, consulte Solución del problema de conectores y Solución del problema de Notifications.

En esta sección se describe la creación del conector, el tema, la suscripción y la alarma mediante la API.

Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte la documentación de la API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Los SDK y la CLI.

Utilice las siguientes operaciones:

1. CreateServiceConnector: cree un conector.

   Ejemplo de solicitud 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: crear un tema.

   Ejemplo de solicitud CreateTopic

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

3. CreateSubscription: para este tema, agregue una suscripción que haga referencia a su dirección de correo electrónico.

   Ejemplo de solicitud CreateSubscription: correo electrónico

   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: cree una alarma que defina el umbral de memoria y haga referencia a este tema.

   Ejemplo de solicitud 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
   }

Para obtener ayuda con el proceso de resolución de problemas, consulte Solución del problema de conectores y Solución del problema de Notifications.