Perguntas frequentes do Cloud Notifications

Perguntas gerais

O que é o serviço Oracle Cloud Infrastructure Notifications?

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 que posso fazer com este serviço?

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.

Como o serviço de Notificações funciona?

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.

Como começo a usar o serviço Notifications?

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.

Como o serviço de Notificações se compara a outros serviços de mensagens disponíveis na Oracle Cloud Infrastructure?

A Oracle Cloud Infrastructure oferece os seguintes serviços de mensagens para entrega de eventos:

  • Streaming
  • Notificações

Embora esses serviços tenham algumas semelhanças, eles abordam casos de uso distintos:

  • O caso de uso mais frequente para o serviço de Notificações é enviar notificações para assinantes interessados registrados e é usado na programação reativa. Este serviço envia notificações usando um modelo de "extração", que elimina a sobrecarga de pesquisas periódicas para atualizações.
  • O caso de uso mais frequente do Streaming é ingerir grandes quantidades de dados contínuos e disponibilizá-los imediatamente para consumo. O serviço de Streaming facilita a ingestão, retenção e reprodução rápida de dados de streaming. Diferentemente do serviço de Notificações, o Streaming permite a reprodução repetida dos dados armazenados.

Principais conceitos

O que é um tópico?

Um tópico é um canal para comunicar mensagens a uma assinatura.

O que é 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:

  • Email: as mensagens são enviadas para um endereço de e-mail especificado.
  • HTTPS (PagerDuty): as mensagens são enviadas ao PagerDuty.
  • HTTPS (Webhook): as mensagens são enviadas para o ponto de extremidade HTTPS.
  • Slack: as mensagens são enviadas a um canal do Slack
  • Oracle Functions: Chame uma função Oracle
  • SMS: As mensagens são enviadas para um número de telefone habilitado para SMS

O que é uma mensagem?

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.

Recursos e funcionalidade

Quais Recursos o serviço de Notificações suporta?

  • Várias integrações de ponto de extremidade e suporte a protocolo de mensagens, como e-mail e PagerDuty
  • Escalável com um serviço totalmente gerenciado que garante durabilidade das mensagens
  • Lógica de repetição inteligente para entregar pelo menos uma vez
  • Suporte de segurança para Gerenciamento de Identidade e Acesso
  • Gerenciamento de Assinaturas

Quais protocolos de notificação esse serviço suporta atualmente?

O Notifications é compatível com Email, PagerDuty, Functions, HTTPS, Slack e SMS.

Quais são as operações de API disponíveis das Notificações e onde posso encontrar documentação?

As seguintes operações são suportadas com mais documentação localizada aqui:

  • Use estas operações de API para gerenciar tópicos:
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.
  • Use estas operações de API para gerenciar assinaturas:
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.
  • Use estas operações de API para publicar mensagens:
Operação Descrição
publishMessage Publica uma mensagem no tópico especificado.

Qual é a durabilidade das mensagens após serem publicadas em um tópico?

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.

As Notificações retêm mensagens?

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.

O serviço de Notificações descarta uma mensagem quando atingem seu tempo máximo 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.

Quantas vezes um destinatário recebe uma notificaçã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.

Posso publicar as mesmas mensagens em vários pontos de extremidade por meio de um único tópico?

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.

As mensagens são entregues na ordem exata em que são publicadas em um tópico?

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.

Os assinantes podem receber apenas um subconjunto de mensagens publicadas em um tópico?

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.

Depois que um tópico for publicado, posso excluir uma mensagem?

Você não pode excluir uma mensagem depois de publicada em um tópico de Notificações.

Posso alterar o assunto e o nome do remetente dos e-mails enviados pelo serviço Notifications?

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.

Operações e solução de problemas

Quais métricas posso usar para monitorar o serviço de Notificações?

  • Aqui estão as principais métricas que você pode usar:
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.

Como sou notificado se houver falha em uma notificação?

Você pode configurar um alarme na métrica NumberOfNotificationFailed por meio do serviço Monitoring. Saiba mais aqui.

O que acontece se eu publicar mensagens em um tópico que não possui assinaturas?

A operação de publicação é bem-sucedida, mas as mensagens são descartadas porque nenhuma assinatura está interessada nelas.

As Notificações retêm mensagens?

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.

O que acontece se um assinante não estiver disponível?

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.

Segurança

Quem pode criar um tópico?

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.

Quem pode publicar mensagens em um tópico?

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.

Vários editores podem publicar em um único tópico?

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.

Quem pode se inscrever em um tópico?

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.

Como um proprietário de tópico concede acesso a assinantes?

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.

Quem pode confirmar ou rejeitar uma assinatura?

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.

Como o Notifications garante que um editor não possa enviar spam para um ponto de extremidade de assinatura e que as mensagens sejam enviadas apenas para assinantes válidos, registrados e interessados?

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.

  1. Assim que um administrador de locatário ou proprietário de tópico adiciona um usuário de ponto de extremidade, o serviço Notifications envia uma mensagem de confirmação para esse assinante.
  2. Após receber a mensagem de confirmação no ponto de extremidade, o assinante confirma a solicitação de assinatura enviando uma resposta válida. Somente então o serviço de Notificações considera a solicitação de assinatura válida. Se não houver resposta, o serviço não enviará notificações para esse ponto de extremidade.

Como o serviço de Notificações autentica chamadas de API?

A autenticação de notificações está integrada ao serviço Oracle Cloud Infrastructure Identity and Access Management (IAM). Saiba mais aqui.

Como um assinante pode cancelar a inscrição de mensagens?

Um assinante pode cancelar a inscrição de um tópico de Notificações das seguintes maneiras:

  • Usando o Console ou a operação da API DeleteSubscription
  • (Somente para assinantes de e-mail) Usando a opção de cancelamento de inscrição no corpo dos e-mails enviados pelo serviço Notifications

Limites e restrições

Quais são as limitações do serviço de Notificação?

  • Observe que os limites de Notificações são definidos em nível regional.
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.
  • Outros limites são os seguintes:
Limites de solicitação
Item Tamanho
Tamanho da mensagem por solicitação 64 KB
Limites da Taxa de Entrega de Mensagens
Protocolo Mensagens por minuto para um único ponto de extremidade
Email 60
HTTPS (PagerDuty) 10

Quanto custa o serviço Notificações?

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 de Notificações oferece uma camada gratuita?

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.

Próximos Passos

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.

Próximas etapas

Para saber mais sobre o serviço de Notificações, consulte os seguintes artigos: