---
title: OCI Monitoring Service
slug: aiops/oci-monitoring-service
docTags: 
createdAt: 2025-07-03T12:34:24.725Z
---

## Visão Geral

Configurar o Oracle Cloud Infrastructure (OCI) para enviar notificações automáticas para o AIOPs, via webhook, sempre que um evento de monitoramento (alarme) é disparado.

A solução funciona através da integração de três componentes principais do OCI:

- **OCI Monitoring Service**: Monitora métricas dos recursos da nuvem
- **OCI Events Service**: Captura mudanças de estado dos recursos
- **OCI Notifications Service**: Envia mensagens para diferentes canais, incluindo webhooks HTTPS

## 1. Criar um Tópico de Notificação

1. **Acesse o Console OCI**
   - Entre no Oracle Cloud Console.
2. **Navegue até Notificações**
   - Menu: Application Integration → Notifications.
3. **Criar Tópico**
   - Selecione o compartimento desejado.
   - Clique em Create Topic.
   - Preencha nome e descrição.
   - Clique em Create.

## 2. Configurar Subscription HTTPS (Webhook)

1. **Acesse o Tópico Criado**
   - Na página do tópico, clique em Create Subscription.
2. **Selecione Protocolo HTTPS**
   - Escolha o protocolo HTTPS (Custom URL).
   - Insira a URL do endpoint do seu webhook.
     - O endpoint deverá ser:
     - `https://<DOMINIO_AIOPS>/services/collector/event`
3. **Salve a Subscription**
   - Aguarde o recebimento do e-mail/URL de confirmação.
   - Acesse a URL de confirmação enviada ao seu endpoint para ativar a subscription (válida por 3 dias).
   - A subscription ficará ativa após a confirmação.

## 3. Configurar Alarmes de Monitoramento

1. **Navegue até Monitoramento**
   - Menu: Observability & Management → Monitoring → Alarm Definitions.
2. **Criar Alarmes**
   - Clique em Create Alarm.
   - Defina o nome do alarme.
   - Selecione a métrica desejada (namespace, nome, intervalo, estatística).
   - Configure a regra de disparo (operador, valor, delay).
   - Em Destination, selecione o tópico criado no passo 1.
   - Salve o alarme.

## 4. (Opcional) Configurar Regras de Eventos

1. **Acesse Eventos**
   - Menu: Observability & Management → Events.
2. **Criar Regra de Evento**
   - Clique em Create Rule.
   - Defina as condições do evento que deseja monitorar.
   - Configure a ação para enviar para o tópico de notificação.
   - Salve a regra.

## 5. Recebendo e Processando Notificações

- **Formato das Mensagens:**
  - O OCI envia notificações em formato JSON via POST para o seu endpoint.
  - O payload contém informações detalhadas sobre o evento/alarme.
- **Headers HTTP:**
  - Incluem metadados como ID da mensagem, nome do tópico, URL de unsubscribe, assinatura, timestamp, entre outros.
- **Validação de Assinatura:**
  - Utilize os headers fornecidos para validar a autenticidade das mensagens recebidas.

## 6. Teste e Validação

1. **Simule um Evento**
   - Dispare um alarme manualmente ou espere um evento real ser gerado.
2. **Verifique o Endpoint**
   - Confirme que o endpoint recebeu a notificação e processou corretamente.
3. **Ajuste e Monitoramento**
   - Ajuste configurações conforme necessário.
   -