Panoramica delle notifiche

Il servizio Notifiche consente di impostare i canali di comunicazione per la pubblicazione dei messaggi utilizzando gli argomenti e le sottoscrizioni . Quando un messaggio viene pubblicato in un topic, il servizio di notifiche invia il messaggio a tutte le sottoscrizioni del topic.

Quando l'endpoint di un sottoscrittore non conferma la ricezione del messaggio, il servizio di notifiche riprova la consegna. Questa situazione può verificarsi quando l'endpoint è offline. Ad esempio, il server di posta elettronica per un indirizzo di posta elettronica potrebbe essere inattivo.

Per modificare la durata dei nuovi tentativi di una sottoscrizione, vedere Aggiornamento di una sottoscrizione.

I concetti riportati di seguito sono essenziali per l'utilizzo del servizio di notifiche.

formattazione semplice

Impostazione per aumentare la leggibilità umana dei messaggi.

Protocolli di sottoscrizione supportati:

• Posta elettronica

Tipi di messaggio supportati:

• Messaggi di allarme (quando le notifiche sono la destinazione)

  Vedere Esempi di messaggi di allarme e Aggiornamento di un allarme dopo lo spostamento di una risorsa.

• Messaggi connettore (quando il servizio di destinazione è Notifiche)

  Vedere Esempi di messaggi del connettore e Aggiornamento di un connettore per l'utilizzo di formati descrittivi.

messaggio

Il contenuto che viene pubblicato in un argomento. Ciascun messaggio viene consegnato almeno una volta per sottoscrizione. Tutti i messaggi inviati sotto forma di e-mail contengono un collegamento per annullare la sottoscrizione al argomento correlato.

notifica

Configurazione per l'invio di messaggi, ad esempio una regola di allarme o evento. Ogni messaggio viene inviato alle sottoscrizioni nell'argomento specificato.

Sono disponibili i seguenti tipi di notifiche:

• Notifica contestuale: creata da un modello di avvio rapido o da opzioni con stato attivo rilevanti per la risorsa specificata.

  Per istruzioni su un'istanza di computazione, vedere Impostazione delle notifiche contestuali per un'istanza.

• Notifica tradizionale: creata da un punto di integrazione supportato.

  Esempi di scenari per le notifiche tradizionali includono il ridimensionamento automatico delle VM, l'invio di messaggi di allarme a Slack e SMS e la riempimento dei ticket Jira per i promemoria.

Dopo aver creato la notifica, è possibile gestirla come al solito. Ad esempio, se la notifica è un allarme, gestirla utilizzando la pagina Allarmi nella console.

sottoscrizione

Endpoint per un argomento. I messaggi pubblicati vengono inviati a ciascuna sottoscrizione relativa a un argomento.

Protocolli di sottoscrizione supportati:

• E-mail:

  Invia un messaggio e-mail quando si pubblica un messaggio nell'argomento padre della sottoscrizione.

  Nota
  
  Segui le best practice per l'integrazione con il servizio di consegna tramite e-mail. Vedere Gestione della reputazione di un mittente e-mail positivo.

  Il contenuto e l'aspetto dei messaggi variano in base al tipo di messaggio. Vedere messaggi di allarme, messaggi evento e messaggi connettore.

  Alcuni tipi di messaggio utilizzano la formattazione descrittiva.

• Funzione:
  Esegue la funzione specificata quando si pubblica un messaggio nell'argomento padre della sottoscrizione. Ad esempio, esegue una funzione per ridimensionare le VM quando viene attivato un allarme associato.
• HTTPS (URL personalizzato):

  Invia le informazioni specificate quando si pubblica un messaggio nell'argomento padre della sottoscrizione.

• PagerDuty:
  Crea un incidente PagerDuty per impostazione predefinita quando si pubblica un messaggio nell'argomento padre della sottoscrizione.
• Slack
  Invia un messaggio al canale Slack specificato per impostazione predefinita quando si pubblica un messaggio nell'argomento padre della sottoscrizione.

  Il contenuto e l'aspetto dei messaggi variano in base al tipo di messaggio. Vedere messaggi di allarme, messaggi evento e messaggi connettore.
• SMS:
  Invia un messaggio di testo utilizzando SMS (Short Message Service) al numero di telefono specificato quando si pubblica un messaggio nell'argomento padre della sottoscrizione. Formati endpoint supportati: formato E.164.

  Nota
  
  

  Le funzionalità SMS internazionali sono necessarie se i messaggi SMS provengono da un numero di telefono di un altro paese. Aggiungiamo continuamente il supporto per più paesi in modo che più utenti possano ricevere messaggi SMS dai numeri di telefono locali.

  Le sottoscrizioni SMS sono abilitate solo per i messaggi inviati dai seguenti servizi Oracle Cloud Infrastructure: annunci, monitoraggio e hub connettore. I messaggi SMS inviati da servizi non supportati vengono eliminati. Vedere Causa: risorsa non supportata utilizzata per SMS.

  Il servizio Notifiche consegna i messaggi SMS da un pool di numeri preconfigurato. È possibile ricevere messaggi SMS da più numeri.

  Il contenuto e l'aspetto dei messaggi variano in base al tipo di messaggio. Vedere Messaggi di allarme SMS e Messaggi del connettore SMS.

  Paesi e aree disponibili

  È possibile utilizzare le notifiche per inviare messaggi SMS ai seguenti paesi e aree geografiche:

  Paese o area	Codice ISO
  Australia	AU
  Brasile	BR
  Canada	CA
  Cile	CL
  Cina	CN
  Costa Rica	CR
  Croazia	HR
  Repubblica Ceca	CZ
  Francia	FR
  Germania	DE
  Ungheria	HU
  India	IN
  Irlanda	IE
  Israele	IL
  Giappone	JP
  Lituania	LT
  Messico	MX
  Paesi Bassi	NL
  Nuova Zelanda	NZ
  Norvegia	NO
  Filippine	PH
  Polonia	PL
  Portogallo	PT
  Romania	RO
  Arabia Saudita	SA
  Singapore	SG
  Sudafrica	ZA
  Corea del Sud	KR
  Spagna	ES
  Svezia	SE
  Svizzera	CH
  Ucraina	UA
  Emirati Arabi Uniti	AE
  Regno Unito	GB
  Stati Uniti	US

argomento

Un canale di comunicazione per l'invio di messaggi alle sottoscrizioni. Ogni nome argomento è univoco nella tenancy.

Risorse pubblicare i messaggi nell'argomento configurato. Le notifiche consegnano i messaggi alle sottoscrizioni attive nell'argomento.

Le risorse che possono inviare messaggi includono allarmi, sottoscrizioni agli annunci, regole di evento, connettori e notifiche contestuali (allarmi e regole di evento). Un utente, un servizio o un'applicazione può anche inviare un messaggio tramite la pubblicazione diretta.

Si consideri ad esempio un allarme configurato per l'invio di messaggi a un argomento. Questo argomento contiene sottoscrizioni a e-mail, Slack e SMS. Quando viene violata la regola di attivazione allarme, l'allarme pubblica un messaggio nell'argomento. Notifiche consegna quindi il messaggio alle sottoscrizioni attive dell'argomento. In questo esempio, la sottoscrizione Slack è in sospeso perché non è stata ancora confermata. Notifiche consegna il messaggio solo alle sottoscrizioni di e-mail e SMS, poiché queste sono le uniche sottoscrizioni attive nell'argomento.

Per le metriche che tengono traccia dei messaggi pubblicati e consegnati, vedere Metriche disponibili: oci_notification.

Allarmi

Quando viene violata la regola di attivazione allarme , l'allarme invia un messaggio di allarme all'argomento configurato. Notifiche consegna quindi il messaggio alle sottoscrizioni attive in tale argomento. Vedere Gestione degli allarmi.

Una notifica contestuale può includere un allarme.

Sottoscrizioni annuncio

Una sottoscrizione annuncio invia messaggi di annuncio della console all'argomento configurato. Notifiche consegna quindi il messaggio alle sottoscrizioni attive in tale argomento.

Regole di evento

Quando viene attivata, una regola evento invia un messaggio di evento all'argomento configurato. Notifiche consegna quindi il messaggio alle sottoscrizioni attive in tale argomento. Vedere Gestione delle regole per gli eventi.

Una notifica contestuale può includere una regola evento.

Connettori

Un connettore invia un messaggio del connettore all'argomento configurato. Notifiche consegna quindi il messaggio alle sottoscrizioni attive in tale argomento. Vedere Gestione dei connettori.

Pubblicazione diretta

Un utente (o un servizio o un'applicazione) invia un messaggio all'argomento configurato. Notifiche consegna quindi il messaggio alle sottoscrizioni attive in tale argomento. Vedere Pubblicazione di un messaggio a un argomento.

Il servizio Notifiche è disponibile in tutte le aree commerciali di Oracle Cloud Infrastructure. Vedere Informazioni sulle aree e sui domini di disponibilità per la lista delle aree disponibili, insieme alle posizioni associate, agli identificativi delle aree, alle chiavi delle aree e ai domini di disponibilità.

Valuta le funzioni dei servizi riportate di seguito quando devi decidere se utilizzare il servizio Notifiche o il servizio di consegna tramite e-mail per inviare i tuoi messaggi e-mail. Per ulteriori informazioni su Consegna e-mail, consulta la panoramica del servizio di consegna e-mail.

La maggior parte dei tipi di risorse Oracle Cloud Infrastructure ha un identificativo univoco assegnato da Oracle chiamato OCID (Oracle Cloud ID). Per informazioni sul formato OCID e su altri modi per identificare le risorse, vedere Identificativi risorsa.

Puoi accedere al servizio di notifiche utilizzando la console o l'API REST delle notifiche. Le istruzioni per la console, l'interfaccia CLI e l'API sono incluse in questa guida. Per un elenco di SDK disponibili, consulta Software Development Kits and Command Line Interface.

Console: per accedere alle notifiche utilizzando la console, è necessario utilizzare un browser supportato. Per andare alla pagina di accesso della console, aprire il menu di navigazione nella parte superiore di questa pagina e selezionare Console dell'infrastruttura. Viene richiesto di immettere il tenant cloud, il nome utente e la password. Aprire il menu di navigazione e selezionare Developer Services. In Integrazione applicazioni, selezionare Notifiche.

API: per accedere alle notifiche tramite l'API, utilizzare API Notifiche.

CLI: vedere Riferimento sulle righe di comando per le notifiche.

Amministratori: per i criteri comuni che consentono ai gruppi di accedere alle risorse di notifiche, vedere Criteri IAM (nella pagina Protezione delle notifiche).

Per un elenco dei limiti applicabili e delle istruzioni per richiedere un aumento del limite, consulta la sezione relativa ai limiti dei servizi. Per impostare limiti specifici del compartimento per una risorsa o una famiglia di risorse, gli amministratori possono utilizzare le quote dei compartimenti.