Cenário: Alarmando Dados de Log

Se você for membro do grupo Administradores, já terá o acesso necessário para executar esse cenário. Caso contrário, você precisará de acesso a Monitoramento e Notificações .

O workflow para criar o conector inclui uma política padrão quando necessário para fornecer permissão para gravar no serviço de destino. Se você não estiver familiarizado com políticas, consulte Visão Geral de Políticas do Serviço IAM.

A configuração é fácil na Console. Como alternativa, você pode usar a CLI ou a API do Oracle Cloud Infrastructure, que permite que você mesmo execute as operações individuais.

Esta seção explica a criação de um conector e de um alarme usando a Console e, em seguida, a atualização do tópico criado com o alarme.

Para obter ajuda para solucionar problemas, consulte Diagnóstico e Solução de Problemas com Conectores e Diagnóstico e Solução de Problemas com Notificações.

Esta seção explica a criação do conector, do tópico, das inscrições e do alarme usando a CLI.

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

1. Crie um conector: Abra um prompt de comando e execute o 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. Crie um tópico: Abra um prompt de comando e execute o comando oci ons topic create:

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

3. Para este tópico, adicione uma assinatura que faça referência ao seu endereço de e-mail. Abra um prompt de comando e execute o 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. Crie um alarme que defina o limite de erro e faça referência a este tópico como destino: Abra um prompt de comando e execute o 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 obter ajuda para diagnosticar e solucionar problemas, consulte Solucionando Problemas dos Conectores e Solucionando Problemas das Notificações.

Esta seção explica a criação do conector, do tópico, da inscrição e do alarme usando a API.

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

Use as seguintes operações:

1. CreateServiceConnector: Cria um conector.

   Exemplo de solicitação 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: Criar um tópico.

   Exemplo de solicitação 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 tópico, adicione uma assinatura que referencie seu endereço de e-mail.

   Exemplo de solicitação 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: cria um alarme que define o limite de memória e faz referência a este tópico.

   Exemplo de solicitação 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 obter ajuda para solucionar problemas, consulte Diagnóstico e Solução de Problemas com Conectores e Diagnóstico e Solução de Problemas com Notificações.