Documentação do Oracle Cloud Infrastructure

Criando uma Regra de Eventos

Crie uma regra no Events para criar automação com base nas alterações de estado dos recursos em toda a tenancy.

    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Serviço Events, selecione Regras.

    2. Em Escopo da Lista, selecione um compartimento no qual você tenha permissão para trabalhar.

      O serviço Events compara as regras que você cria neste compartimento com mensagens de evento emitidas por recursos deste compartimento e de todos os compartimentos filhos.

    3. Clique em Criar Regra.

    4. No painel Criar Regra, forneça um nome amigável para a regra e uma descrição do que a regra faz. Você pode alterar os dois valores mais tarde. Evite inserir informações confidenciais.

      Na área Condições da Regra, você pode definir filtros com base em tipos de evento, atributos e tags para limitar os eventos que acionam ações. Consulte Fazendo Correspondência de Eventos com Filtros. Conclua as seguintes etapas para definir esses filtros.

      Dica

      Para corresponder a todos os eventos, deixe este campo em branco. Pule para a etapa 8.

    5. Para filtrar eventos adicionando um tipo de evento, siga estas etapas.

      1. Para Condição, selecione Tipo de Evento.
      2. Selecionar um serviço.
      3. Em Tipo de Evento, selecione um ou mais tipos de eventos para este serviço.
      4. Para adicionar tipos de evento para outro serviço, clique em + Outra Condição e selecione Tipo de Evento para repetir as etapas anteriores para adicionar tipos de evento para outro serviço.

    6. Para filtrar ainda mais os tipos de evento usando atributos, siga estas etapas. Crie uma condição de tipo de evento antes de adicionar um atributo.

      1. Após adicionar um tipo de evento, clique em + Outra Condição.
      2. Em Condição, selecione Atributo.
      3. Selecione um atributo.
      4. (Opcional) Em Valores do Atributo, selecione ou informe valores para o atributo.

    7. Para filtrar eventos usando tags, siga estas etapas.

      As tags de filtro ajudam a aprimorar a automação ao escolher apenas recursos que contenham uma tag específica. Se você quiser usar tags para organizar suas regras, use tags de recursos. Para obter mais informações, consulte Gerenciando Tags para Regras.

      1. Para Condição, selecione Tag de Filtro
      2. Selecionar um namespace de tag.

        Para especificar uma tag de formato livre, selecione Nenhum (add a free-form tag).

      3. Selecione uma chave de tag.
      4. (Opcional) Insira um valor de tag.
      5. Para adicionar outra tag, clique em + Outra Condição e repita as etapas anteriores.

    8. Para validar a regra com base nas condições especificadas, clique em Validar Regra e siga estas etapas no painel Validar Regra.

      Você pode avaliar uma regra em relação a um tipo de evento de cada vez. Para testar diversos tipos de evento, repita estas etapas conforme necessário.

      1. Em Nome do Serviço, selecione um serviço.
      2. Em Tipo de Evento, selecione um tipo de evento.

        Um exemplo de evento aparece com base nas suas seleções feitas. Edite os valores no evento para corresponder aos valores de quaisquer atributos e tags que você adicionou à regra. Para obter mais informações, consulte Conteúdo de uma Mensagem de Evento.

      3. Clique em Verificar se o Exemplo de Evento Corresponde à Regra.
      4. Se a regra não corresponder, use o editor de regras para fazer as seguintes alterações, conforme necessário: 
        • Adicionar ou remover tipos de evento
        • Adicionar ou remover valores ou atributos
        • Adicionar ou remover tags

        • Inserir caracteres curinga

        Para obter mais informações, consulte Fazendo Correspondência de Eventos com Filtros.

      5. Clique em Cancelar.

    9. Para exibir eventos de referência (exemplo), clique em Exibir exemplos de eventos (JSON) e siga essas etapas no painel Exibir Exemplos de Eventos.

      1. Em Nome do Serviço, selecione um serviço.
      2. Em Tipo de Evento, selecione um tipo de evento.

        Um exemplo de evento aparece com base em suas seleções. Use o visualizador de eventos para procurar eventos de referência.

      3. Clique em Concluído.

        Para obter mais informações, consulte Conteúdo de uma Mensagem de Evento e Fazendo Correspondência de Eventos com Filtros.

    10. Para Tipo de Ação, especifique o recurso a ser acionado quando o filtro encontrar uma correspondência.
      • Se você selecionar Notificações, selecione o compartimento no qual o tópico que deseja usar está localizado e, em seguida, selecione o tópico.
      • Se você selecionar Streaming, selecione o compartimento no qual o stream que você deseja usar está localizado e, em seguida, selecione o stream.
      • Se você selecionar Funções, selecione o compartimento no qual a função que você deseja usar está localizada, selecione o aplicativo de função e selecione a função.

      Para adicionar outra ação, clique em + Outra Ação.

    11. Clique em Criar Regra.

  • Use o comando oci event rule create e os parâmetros necessários para criar uma regra:

    oci events rule create --compartment-id compartment_ocid --condition condition --display-name display_name [OPTIONS]

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateRule para criar uma regra.