O Oracle Cloud Infrastructure Notifications é um serviço de publicação-assinatura totalmente gerenciado que envia mensagens para vários pontos de extremidade de assinatura em escala. O Notifications suporta notificações por push para e-mail, PagerDuty, Functions, HTTPS, Slack e pontos de extremidade SMS, além do suporte integrado com Oracle Cloud Infrastructure Monitoring e Service Connector Hub.
O caso de uso mais comum do Notifications será o suporte a mensagens do Monitoring e ao Service Connector Hub para enviar alertas de aplicações. Por exemplo, você pode configurar alarmes do Oracle Cloud Infrastructure Monitoring para enviar notificações a um tópico. Ao assinar o tópico usando o Email ou o PagerDuty, você é imediatamente notificado sobre anomalias na sua infraestrutura de nuvem. Outra implementação é usar nossa integração de protocolo de e-mail para permitir que o serviço Notifications envie mensagens em nome de seus serviços para assinantes especificados. Para casos de uso que variam de redefinições de senha, lembretes de calendário e até sugestões de carrinho de compras, o serviço de Notificações fornece flexibilidade para desacoplar serviços com suporte para os protocolos mais populares e integrações de terceiros.
O serviço de notificações usa uma estrutura de publicação-assinatura na qual os editores de mensagens são dissociados dos assinantes da mensagem. Você configura canais de comunicação para publicar mensagens usando tópicos e assinaturas. Um tópico é um canal para comunicar mensagens a uma assinatura. Uma assinatura é um ponto de extremidade para um protocolo suportado. Quando uma mensagem é publicada em um tópico, o serviço envia a mensagem para todas as assinaturas do tópico.
Você pode acessar o serviço de Notificações usando o Console (uma interface baseada em navegador) ou a API REST ou CLI. Para obter uma lista dos SDKs disponíveis, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.
A Oracle Cloud Infrastructure oferece os seguintes serviços de mensagens para entrega de eventos:
Embora esses serviços tenham algumas semelhanças, eles abordam casos de uso distintos:
Um tópico é um canal para comunicar mensagens a uma assinatura.
Uma assinatura é um ponto de extremidade para um tópico. As mensagens publicadas são enviadas para cada assinatura para um tópico específico. Atualmente, os seguintes protocolos de assinatura são suportados:
O conteúdo que é publicado em um tópico. Cada mensagem é entregue pelo menos uma vez por assinatura. Toda mensagem enviada como e-mail contém um link para cancelar a inscrição no tópico relacionado.
O Notifications é compatível com Email, PagerDuty, Functions, HTTPS, Slack e SMS.
As seguintes operações são suportadas com mais documentação localizada aqui:
| Operação | Descrição |
|---|---|
| createTopic | Cria um tópico no compartimento especificado. |
| getTopic | Fornece informações sobre a configuração do tópico especificado. |
| listTopics | Lista os tópicos no compartimento especificado. |
| updateTopic | Atualiza a configuração do tópico especificado. |
| deleteTopic | Exclui o tópico especificado. |
| Operação | Descrição |
|---|---|
| createSubscription | Cria uma assinatura para o tópico especificado. |
| deleteSubscription | Exclui a assinatura especificada. |
| listSubscriptions | Lista as assinaturas no compartimento ou tópico especificado. |
| getSubscription | Obtém as informações de configuração da assinatura especificada. |
| updateSubscription | Atualiza a configuração da assinatura especificada. |
| getConfirmSubscription | Obtém os detalhes de confirmação para a assinatura especificada. |
| resendSubscriptionConfirmation | Envia novamente os detalhes de confirmação para a assinatura especificada. |
| getUnsubscription | Obtém os detalhes de cancelamento da assinatura especificada. |
| Operação | Descrição |
|---|---|
| publishMessage | Publica uma mensagem no tópico especificado. |
Todas as mensagens publicadas em um tópico do Notifications têm duração na região. Quando uma mensagem é publicada em um tópico, ela é replicada de forma síncrona para três domínios de disponibilidade em uma região antes que uma confirmação seja enviada ao publicador da mensagem.
Quando o ponto de extremidade de um assinante não confirma o recebimento de uma mensagem, o serviço repete a entrega e retém a mensagem por até duas horas após o horário em que a mensagem for publicada em um tópico. O serviço tenta entregar mensagens dentro da janela de retenção.
Sim. O serviço de notificações descarta uma mensagem quando atinge seu tempo máximo de retenção, que é de duas horas, independente da mensagem ter sido entregue ou não.
O serviço Notifications entrega mensagens pelo menos uma vez para um ponto de extremidade de assinatura. Com essas implementações, a duplicação pode ocorrer ocasionalmente e é recomendável que o destinatário lide com notificações duplicadas.
O Notifications pode ser configurado para entregar mensagens para vários pontos de extremidade de um único tópico. Por exemplo, você pode enviar um alarme do Oracle Cloud Infrastructure Monitoring para um endereço de e-mail e/ou ponto de extremidade do PagerDuty ao mesmo tempo.
O serviço de notificações entrega mensagens do editor na ordem em que são publicadas em um tópico. No entanto, devido à natureza das partições de rede, estabilidade da conexão com a internet e falha transitória, o serviço de Notificações pode entregar mensagens fora dessa ordem.
Atualmente, todas as mensagens publicadas em um tópico são entregues a todos os pontos de extremidade de assinatura desse tópico. Os assinantes não podem se inscrever seletivamente em um subconjunto de mensagens.
Você não pode excluir uma mensagem depois de publicada em um tópico de Notificações.
Você pode alterar a linha de assunto de cada mensagem, passando o assunto como um parâmetro na operação da API PublishMessage. Atualmente, você não pode alterar o nome padrão do remetente dos e-mails enviados pelo serviço Notifications.
| Nome da Métrica | Descrição |
|---|---|
| Contagem de Mensagens Publicadas | O número de mensagens publicadas em Notificações. |
| Contagem de Mensagens Entregues | O número de mensagens entregues com sucesso. |
| Contagem de Mensagens com Falha | O número de mensagens que não foram entregues. |
| Tamanho das Mensagens Publicadas (bytes) | O tamanho total das mensagens publicadas. |
| Tamanho das Mensagens Entregues (bytes) | O tamanho total de mensagens entregues com sucesso. |
| Tamanho das Mensagens com Falha (bytes) | O tamanho total de mensagens que falharam ao serem entregues. |
Você pode configurar um alarme na métrica NumberOfNotificationFailed por meio do serviço Monitoring. Saiba mais aqui.
A operação de publicação é bem-sucedida, mas as mensagens são descartadas porque nenhuma assinatura está interessada nelas.
Quando o ponto de extremidade de um assinante não confirma o recebimento de uma mensagem, o serviço repete a entrega e retém a mensagem por até duas horas após o horário em que a mensagem for publicada em um tópico. O serviço tenta entregar mensagens dentro da janela de retenção.
Se o Notificações não receber uma confirmação de um ponto de extremidade de assinatura, o serviço tentará reenviar as mensagens por até duas horas. Essa situação pode ocorrer quando o ponto de extremidade está offline. Por exemplo, o serviço PagerDuty pode estar offline.
Por padrão, os administradores de Inquilinos da Oracle Cloud Infrastructure têm permissões para criar tópicos. No entanto, os administradores de Inquilinos podem conceder permissões e políticas para permitir que grupos de usuários criem tópicos também. Para mais informações, consulte Conceitos básicos de políticas. Para detalhes específicos sobre como escrever políticas para cada um dos diferentes serviços, consulte Referência de Política. Para políticas comuns que dão aos grupos acesso a notificações, consulte também Permitir que um grupo gerencie tópicos, Permitir que um grupo gerencie assinaturas de tópicos e Permitir que um grupo publique mensagens em tópicos.
Por padrão, o proprietário do tópico pode publicar mensagens, no entanto, outros usuários da Oracle Cloud Infrastructure podem receber permissões. Consulte Permitir que um grupo publique mensagens em tópicos.
Um proprietário do tópico pode definir permissões explícitas para permitir que mais de um usuário ou inquilino publique em um tópico. Por padrão, apenas os proprietários de tópicos têm permissão para publicar em um tópico, para ajustar suas políticas, saiba mais em permitir que um grupo publique mensagens em tópicos.
Os assinantes podem ser adicionados pelo administrador do inquilino ou pelo proprietário do tópico. Consulte Políticas de Notificações e gerenciamento de assinaturas para obter maiores informações.
O proprietário do tópico pode conceder permissão de assinatura a um tópico para os assinantes. Para obter mais informações, consulte Políticas Comuns para Publicação de Notificações.
No e-mail, os assinantes receberão um URL de confirmação de assinatura quando forem adicionados. Para obter mais ajuda com a confirmação da assinatura e o reenvio dos detalhes da confirmação, saiba mais aqui.
Para garantir que um ponto de extremidade do assinante não possa ser alvo de spam e que as mensagens sejam enviadas apenas para pontos de extremidade registrados e válidos, o serviço Notifications requer uma inclusão explícita de um assinante.
A autenticação de notificações está integrada ao serviço Oracle Cloud Infrastructure Identity and Access Management (IAM). Saiba mais aqui.
Um assinante pode cancelar a inscrição de um tópico de Notificações das seguintes maneiras:
| Recurso | Créditos Universais Mensais | Pagamento Conforme o Uso ou Promocional |
|---|---|---|
| Tópicos | 50 (Ativo ou Criando*) por locação | Entre em contato |
| Assinaturas | 10 (ativo ou pendente*) por tópico \r 100 (pendente*) por tenancy |
Entre em contato |
| Para Tópicos/Assinaturas adicionais, Entre em Contato para aumentar os limites. | ||
| Item | Tamanho |
|---|---|
| Tamanho da mensagem por solicitação | 64 KB |
| Protocolo | Mensagens por minuto para um único ponto de extremidade |
|---|---|
| 60 | |
| HTTPS (PagerDuty) | 10 |
A precificação do serviço de Notificações é simples e intuitiva. Os clientes pagam por entrega de mensagem. Para HTTPS, os clientes pagam US$ 0,60 por milhão de mensagens por mês. Para e-mails, os clientes pagam US$ 0,02 por 1.000 e-mails enviados por mês. Para SMS, os clientes pagam por SMS de acordo com o país de destino.
O serviço Notifications introduz uma camada que permite aos clientes da Oracle Cloud Infrastructure começar gratuitamente. A cada mês, os clientes podem entregar 1 milhão de mensagens aos pontos de extremidade HTTPS e 1.000 mensagens de e-mail sem incorrer em nenhum custo.
Se o Notificações não receber uma confirmação de um ponto de extremidade de assinatura, o serviço tentará reenviar as mensagens por até duas horas. Essa situação pode ocorrer quando o ponto de extremidade está offline. Por exemplo, o serviço PagerDuty pode estar offline.