通知の概要

通知サービスを使用すると、トピック およびサブスクリプション を使用してメッセージを公開するための通信チャネルを設定できます。メッセージがトピックに公開されると、通知サービスはトピックのすべてのサブスクリプションにメッセージを送信します。

サブスクライバのエンドポイントがメッセージの受信を確認しないと、通知サービスは配信を再試行します。この状況は、エンドポイントがオフラインの場合に発生することがあります。たとえば、電子メール・アドレスの電子メール・サーバーが停止している可能性があります。

サブスクリプションの再試行期間を変更するには、サブスクリプションの配信ポリシーの更新を参照してください。

通知の作業には、次の概念が必要です。

わかりやすい書式設定

メッセージの読みやすさを向上させる設定。

サポートされているサブスクリプション・プロトコル:

• 電子メール

サポートされているメッセージ・タイプ:

• アラーム・メッセージ(通知が宛先の場合)

  アラーム・メッセージの例およびリソースの移動後のアラームの更新を参照してください。

• コネクタ・メッセージ(通知がターゲット・サービスの場合)

  コネクタ・メッセージの例およびわかりやすいフォーマットを使用するためのコネクタの更新を参照してください。

メッセージ

トピックに公開されるコンテンツ。各メッセージは、サブスクリプション当たり少なくとも1回配信されます。電子メールとして送信されるすべてのメッセージには、関連トピックからサブスクライブ解除するためのリンクが含まれています。

通知

アラームやイベント・ルールなどのメッセージを送信するための構成。各メッセージは、指定されたトピックのサブスクリプションに送信されます。

使用可能な通知のタイプは次のとおりです。

• コンテキスト通知: 特定のリソースに関連するクイック・スタート・テンプレートまたはフォーカスされたオプションから作成されます。

  コンピュート・インスタンスの手順は、インスタンスのコンテキスト通知の設定を参照してください。

• 従来の通知: サポートされている統合ポイントから作成されます。

  従来の通知のシナリオの例として、VMの自動サイズ変更、SlackおよびSMSへのアラーム・メッセージの送信、リマインダのJiraチケットのファイリングがあります。

通知を作成した後は、通常どおり管理できます。たとえば、通知がアラームの場合、コンソールの「アラーム」ページを使用して管理します。

サブスクリプション

トピックのエンドポイント。公開されたメッセージは、トピックの各サブスクリプションに送信されます。

サポートされているサブスクリプション・プロトコル:

• 電子メール:

  サブスクリプションの親トピック にメッセージ を公開する場合に電子メール・メッセージを送信します。

  ノート
  
  電子メール配信との統合に関するベスト・プラクティスに従います。肯定的な電子メール送信者評価の保守および電子メールのカスタム・ドメインの設定を参照してください。

  メッセージの内容と表示は、メッセージ・タイプによって異なります。alarm messages、event messagesおよびconnector messagesを参照してください。

  一部のメッセージ・タイプでは、フレンドリな書式設定が使用されます。

• ファンクション:
  サブスクリプションの親トピックにメッセージを公開する場合に指定したファンクションを実行します。たとえば、関連するアラームがトリガーされたときに、ファンクションを実行してVMをサイズ変更します。
• HTTPS (カスタムURL):

  サブスクリプションの親トピック にメッセージ を公開する場合に指定した情報を送信します。

• PagerDuty:
  サブスクリプションの親トピック にメッセージ を公開する場合にデフォルトでPagerDutyインシデントを作成します。
• Slack
  サブスクリプションの親トピック にメッセージ を公開する場合に、デフォルトで指定のSlackチャネルにメッセージを送信します。

  メッセージの内容と表示は、メッセージ・タイプによって異なります。アラーム・メッセージ、イベント・メッセージおよびコネクタ・メッセージを参照してください。
• SMS:
  メッセージをサブスクリプションの親トピックに公開すると、ショート・メッセージ・サービス(SMS)を使用して、指定された電話番号にテキスト・メッセージが送信されます。サポートされるエンドポイント・フォーマット: E.164形式。

  ノート
  
  

  SMSメッセージが別の国の電話番号から送信される場合は、国際SMS機能が必要です。より多くのユーザーがローカルの電話番号からSMSメッセージを受信できるよう、サポートされる国を継続的に増やしていきます。

  SMSサブスクリプションは、Oracle Cloud Infrastructureサービス(お知らせ、モニタリングおよびコネクタ・ハブ)によって送信されたメッセージに対してのみ有効です。サポートされていないサービスから送信されたSMSメッセージは削除されます。原因: SMSに使用されているサポートされていないリソースを参照してください。

  通知サービスは、事前に構成された番号のプールからSMSメッセージを配信します。複数の番号からSMSメッセージを受信する場合があります。

  メッセージの内容と表示は、メッセージ・タイプによって異なります。SMSアラーム・メッセージおよびSMSコネクタ・メッセージを参照してください。

  使用可能な国とリージョン

  通知を使用して、次の国およびリージョンにSMSメッセージを送信できます:

  国または地域	ISOコード
  オーストラリア	AU
  ブラジル	BR
  カナダ	CA
  チリ	CL
  中国	CN
  コスタリカ	CR
  クロアチア	HR
  チェコ	CZ
  フランス	FR
  ドイツ	DE
  ハンガリー	HU
  インド	IN
  アイルランド	IE
  イスラエル	IL
  日本	JP
  リトアニア	LT
  メキシコ	MX
  オランダ語	NL
  ニュージーランド	NZ
  ノルウェー	NO
  フィリピン	PH
  ポーランド	PL
  ポルトガル	PT
  ルーマニア	RO
  サウジアラビア	SA
  シンガポール	SG
  南アフリカ	ZA
  韓国	KR
  スペイン	ES
  スウェーデン	SE
  スイス	CH
  ウクライナ	UA
  米国	AE
  イギリス	GB
  アメリカ	US

トピック

メッセージをサブスクリプションに送信するための通信チャネル。各トピック名はテナンシ間で一意です。

リソースは、構成されたトピックにメッセージを公開します。通知は、トピックのアクティブなサブスクリプションにメッセージを配信します。

メッセージを送信できるリソースには、アラーム、お知らせサブスクリプション、イベント・ルール、コネクタおよびコンテキスト通知(アラームおよびイベント・ルール)が含まれます。(ユーザー、サービスまたはアプリケーションは、直接公開を介してメッセージを送信することもできます。)

たとえば、トピックにメッセージを送信するように構成されたアラームについて考えてみます。このトピックでは、電子メール、SlackおよびSMSサブスクリプションについて説明します。アラーム・トリガー・ルールに違反すると、アラームはトピックにメッセージをパブリッシュします。通知は、トピックのアクティブなサブスクリプションにメッセージを配信します。この例では、Slackサブスクリプションはまだ確認されていないため、保留中です。通知はトピック内の唯一のアクティブなサブスクリプションであるため、電子メールおよびSMSサブスクリプションにのみメッセージが配信されます。

公開済および配信済メッセージをトラッキングするメトリックについては、使用可能なメトリック: oci_notificationを参照してください。

警告

アラームのトリガー・ルールに違反すると、アラームはアラーム・メッセージを構成済のトピックに送信します。通知は、そのトピックのアクティブなサブスクリプションにメッセージを配信します。アラームの管理を参照してください。

コンテキスト通知にはアラームを含めることができます。

アナウンスメント・サブスクリプション

お知らせサブスクリプションは、コンソールのお知らせメッセージを構成済のトピックに送信します。次に、通知は、そのトピックのアクティブなサブスクリプションにメッセージを配信します。

イベント・ルール

トリガーされると、イベント・ルールはイベント・メッセージを構成済のトピックに送信します。通知は、そのトピックのアクティブなサブスクリプションにメッセージを配信します。イベントのルールの管理を参照してください。

コンテキスト通知には、イベント・ルールを含めることができます。

コネクタ

コネクタは、コネクタ・メッセージを構成済のトピックに送信します。通知は、そのトピックのアクティブなサブスクリプションにメッセージを配信します。コネクタの管理を参照してください。

直接公開

ユーザー(またはサービスまたはアプリケーション)は、メッセージを構成済のトピックに送信します。通知は、そのトピックのアクティブなサブスクリプションにメッセージを配信します。トピックへのメッセージの公開を参照してください。

通知サービスは、すべてのOracle Cloud Infrastructure商用リージョンで使用できます。使用可能なリージョンのリストと、関連する場所、リージョン識別子、リージョン・キーおよび可用性ドメインは、リージョンおよび可用性ドメインについてを参照してください。

通知サービスまたは電子メール配信サービスを使用して電子メール・メッセージを送信するかどうかを決定する際には、次のサービス機能を使用することを検討してください。電子メール配信の詳細は、電子メール配信サービスの概要を参照してください。

ほとんどのタイプのOracle Cloud Infrastructureリソースには、Oracle Cloud ID (OCID)と呼ばれるOracleによって割り当てられた一意の識別子があります。OCIDのフォーマットおよびリソースを識別するその他の方法の詳細は、リソース識別子を参照してください。

コンソールまたは通知REST APIを使用して通知サービスにアクセスできます。コンソール、CLIおよびAPIのための手順は、このガイド全体に含まれています。使用可能なSDKのリストは、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

コンソール: コンソールを使用して通知にアクセスするには、サポートされているブラウザを使用する必要があります。コンソールのサインイン・ページに移動するには、このページの上部にあるナビゲーション・メニューを開き、「Infrastructureコンソール」をクリックします。クラウド・テナント、ユーザー名およびパスワードの入力を求められます。ナビゲーション・メニューを開き、「開発者サービス」をクリックします「アプリケーション統合」で、「通知」をクリックします。

API: APIを介して通知にアクセスするには、通知APIを使用します。

CLI: 通知のコマンドライン・リファレンスを参照してください。

管理者: グループに通知リソースへのアクセス権を付与する共通ポリシーについては、IAMポリシー(通知ページの保護)を参照してください。

適用可能な制限のリストと制限拡大のリクエスト方法は、サービス制限を参照してください。リソースまたはリソース・ファミリにコンパートメント固有の制限を設定するために、管理者は、コンパートメント割当てを使用できます。