Visão Geral das Notificações

O serviço Notifications permite que você configure canais de comunicação para publicar mensagens usando tópicos e inscrições . Quando uma mensagem é publicada em um tópico, o serviço Notifications envia a mensagem a todas as inscrições do tópico.

Quando o ponto final de um inscrito não confirma o recebimento da mensagem, o serviço Notifications faz uma nova tentativa de entrega. Essa situação pode ocorrer quando o ponto final está off-line. Por exemplo, o servidor do endereço de e-mail pode estar desativado.

Para alterar a duração da repetição de uma assinatura, consulte Atualizando uma Assinatura.

Os conceitos a seguir são essenciais para trabalhar com o serviço Notifications.

formatação amigável

Uma configuração para aumentar a legibilidade humana das mensagens.

Protocolos de assinatura suportados:

• E-mail

Tipos de mensagem suportados:

• Mensagens de alarme (quando o Notifications é o destino)

  Consulte exemplos de mensagem de alarme e Updating an Alarm After Moving a Resource.

• Mensagens do conector (quando o Notifications é o serviço de destino)

  Consulte exemplos de mensagem de conector e Atualizando um Conector para Usar Formatos Amigáveis.

mensagem

O conteúdo publicado em um tópico. Cada mensagem é entregue pelo menos uma vez por inscrição. Cada mensagem enviada como e-mail contém um link para cancelar a inscrição no tópico relacionado.

notificação

Uma configuração para enviar mensagens, como uma regra de alarme ou evento. Cada mensagem é enviada a inscrições no tópico especificado.

Estão disponíveis os seguintes tipos de notificações:

• Notificação contextual: Criada com base em um modelo de início rápido ou em opções focadas relevantes para o recurso fornecido.

  Para obter instruções com uma instância de computação, consulte Configurando Notificações Contextuais para uma Instância.

• Notificação tradicional: Criada a partir de um ponto de integração suportado.

  Exemplos de cenários para notificações tradicionais incluem redimensionamento automático de VMs, envio de mensagens de alarme para Slack e SMS e preenchimento de tickets do Jira para lembretes.

Depois de criar a notificação, você pode gerenciá-la como de costume. Por exemplo, se a notificação for um alarme, gerencie-a usando a página Alarmes na Console.

inscrição

Um ponto final de um tópico. As mensagens publicadas são enviadas a cada inscrição em um tópico.

Protocolos de assinatura suportados:

• E-mail:

  Envia um e-mail quando você publica uma mensagem  no tópico  pai da inscrição.

  Observação
  
  Siga as melhores práticas para integração com o serviço Email Delivery. Consulte Manter uma Reputação Positiva de Remetente de E-mail.

  O conteúdo e a aparência da mensagem variam de acordo com o tipo de mensagem. Consulte mensagens de alarme, mensagens de evento e mensagens de conector.

  Alguns tipos de mensagem usam Formatação amigável.

• Função:
  Executa a função especificada quando você publica uma mensagem no tópico pai da inscrição. Por exemplo, executa uma função para redimensionar VMs quando um alarme associado é acionado.
• HTTPS (URL Personalizado):

  Envia informações específicas quando você publica uma mensagem  no tópico  pai da inscrição.

• PagerDuty:
  Por padrão, cria um incidente PagerDuty quando você publica uma mensagem no tópico pai da inscrição.
• Slack:
  Por padrão, envia uma mensagem para o canal Slack especificado quando você publica uma mensagem  no tópico  pai da inscrição.

  O conteúdo e a aparência da mensagem variam de acordo com o tipo de mensagem. Consulte mensagens de alarme, mensagens de evento e mensagens de conector.
• SMS:
  Envia uma mensagem de texto usando o SMS (Short Message Service) para o número de telefone especificado quando você publica uma mensagem no tópico pai da assinatura. Formatos de ponto final suportados: formato E.164.

  Observação
  
  

  Recursos internacionais de SMS serão necessários se as mensagens SMS vierem de um número de telefone em outro país. Acrescentamos continuamente suporte a mais países para que mais usuários possam receber mensagens SMS de números de telefone locais.

  As assinaturas SMS só são ativadas para mensagens enviadas pelos seguintes serviços do Oracle Cloud Infrastructure: Announcements, Monitoring e Connector Hub. As mensagens SMS enviadas por serviços não suportados são eliminadas. Consulte Causa: Recurso sem suporte usado para SMS.

  O serviço Notifications entrega mensagens SMS de um pool de números pré-configurado. Você pode receber mensagens SMS de vários números.

  O conteúdo e a aparência da mensagem variam de acordo com o tipo de mensagem. Consulte mensagens de alarme SMS e mensagens do conector SMS.

  Países e Regiões Disponíveis

  Você pode usar o serviço Notifications para enviar mensagens SMS aos seguintes países e regiões:

  País ou região	Código ISO
  Austrália	AU
  Brasil	BR
  Canadá	CA
  Chile	CL
  China	CN
  Costa Rica	CR
  Croácia	HR
  China	CZ
  França	FR
  Alemanha	DE
  Hungria	HU
  Índia	IN
  Irlanda	IE
  Israel	IL
  Japão	JP
  Lituânia	LT
  México	MX
  Holanda	NL
  Nova Zelândia	NZ
  Noruega	NO
  Filipinas	PH
  Polônia	PL
  Portugal	PT
  Romênia	RO
  Arábia Saudita	SA
  Singapura	SG
  África do Sul	ZA
  Coreia do Sul	KR
  Espanha	ES
  Suécia	SE
  Suíça	CH
  Ucrânia	UA
  Emirados Árabes Unidos	AE
  Reino Unido	GB
  Estados Unidos	US

tópico

Um canal de comunicação para enviar mensagens a inscrições. Cada nome de tópico é exclusivo na tenancy.

Mensagens de publicação de recursos para o tópico configurado. Em seguida, as notificações entregam mensagens a assinaturas ativas no tópico.

Os recursos que podem enviar mensagens incluem alarmes, assinaturas de anúncios, regras de evento, conectores e notificações contextuais (alarmes e regras de evento). (Um usuário, serviço ou aplicativo também pode enviar uma mensagem por meio de publicação direta.)

Por exemplo, considere um alarme configurado para enviar mensagens a um tópico. Este tópico contém assinaturas de e-mail, Slack e SMS. Quando a regra de trigger de alarme é violada, o alarme publica uma mensagem no tópico. Em seguida, o Notifications entrega a mensagem às assinaturas ativas do tópico. Neste exemplo, a assinatura do Slack está pendente porque ainda não foi confirmada. O Notifications entrega a mensagem apenas às assinaturas de e-mail e SMS, porque essas são as únicas assinaturas ativas no tópico.

Para obter métricas que rastreiam mensagens publicadas e entregues, consulte Métricas Disponíveis: oci_notification.

Alarmes

Quando uma regra de trigger de alarme é violada, o alarme envia uma mensagem de alarme para o tópico configurado. Em seguida, o Notifications entrega a mensagem a assinaturas ativas nesse tópico. Consulte Gerenciando Alarmes.

Uma notificação contextual pode incluir um alarme.

Inscrições em anúncios

Uma assinatura de anúncio envia mensagens de anúncio da console para o tópico configurado. Em seguida, o Notifications entrega a mensagem a assinaturas ativas nesse tópico.

Regras de Eventos

Quando acionada, uma regra de evento envia uma mensagem de evento para o tópico configurado. Em seguida, o Notifications entrega a mensagem a assinaturas ativas nesse tópico. Consulte Gerenciando Regras de Eventos.

Uma notificação contextual pode incluir uma regra de evento.

Conectores

Um conector envia uma mensagem de conector para o tópico configurado. Em seguida, o Notifications entrega a mensagem a assinaturas ativas nesse tópico. Consulte Gerenciando Conectores.

Publicação Direta

Um usuário (ou um serviço ou aplicativo) envia uma mensagem para o tópico configurado. Em seguida, o Notifications entrega a mensagem a assinaturas ativas nesse tópico. Consulte Publicando uma Mensagem em um Tópico.

O serviço Notifications está disponível em todas as regiões comerciais do Oracle Cloud Infrastructure. Consulte Sobre Regiões e Domínios de Disponibilidade para obter a lista de regiões disponíveis, juntamente com locais associados, identificadores de região, chaves de região e domínios de disponibilidade.

Considere os recursos dos serviços a seguir quando decidir usar o serviço Notifications ou o serviço Email Delivery para enviar as suas mensagens de e-mail. Para obter mais informações sobre o serviço Email Delivery, consulte Visão Geral do Serviço Email Delivery.

A maioria dos tipos de recursos do Oracle Cloud Infrastructure tem um identificador exclusivo designado pela Oracle chamado OCID (Oracle Cloud ID). Para obter informações sobre o formato OCID e outras maneiras de identificar os seus recursos, consulte Identificadores de Recursos.

Você pode acessar o serviço Notifications usando a Console ou a API REST do serviço Notifications. Instruções para a Console, CLI e API estão incluídas neste guia. Para ver uma lista de SDKs disponíveis, consulte SDKs (Software Development Kits) e a CLI (Command Line Interface).

Console: Para acessar o Notifications usando a Console, você deve usar um browser suportado. Para ir até a página de acesso da Console, abra o menu de navegação na parte superior desta página e selecione Console de Infraestrutura. Você é solicitado a digitar seu tenant na nuvem, seu nome de usuário e sua senha. Abra o menu de navegação e selecione Serviços ao Desenvolvedor. Em Integração de Aplicativos, selecione Notificações.

API: Para acessar o serviço Notifications por meio da API, use a API Notifications.

CLI: Consulte Referência de Linha de Comando para o serviço Notifications.

Administradores: Para políticas comuns que dão aos grupos acesso aos recursos do serviço Notifications, consulte Políticas do Serviço IAM (na página Protegendo Notificações).

Para obter uma lista de limites e instruções aplicáveis à solicitação de um aumento de limite, consulte Limites do Serviço. Para definir limites específicos dos compartimentos em um recurso ou em família de recursos, os administradores podem usar cotas de compartimento.