通知の概要

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

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

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

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

友好的な書式設定

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

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

• 電子メール

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

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

  alarm message examplesおよびUpdating an Alarm After Moving a Resourceを参照してください。

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

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

メッセージ

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

通知

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

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

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

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

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

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

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

サブスクリプション

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

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

• 電子メール:

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

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

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

  一部のメッセージ・タイプでは、わかりやすい書式設定が使用されます。

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

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

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

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

  ノート
  
  

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

  SMSサブスクリプションは、Oracle Cloud Infrastructureサービス(のお知らせ、MonitoringおよびConnector Hub)によって送信されたメッセージに対してのみ有効です。サポートされていないサービスから送信された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
  Switzerland	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を使用して、Notificationsサービスにアクセスできます。コンソール、CLIおよびAPIに関する手順は、このガイド全体に記載されています。使用可能なSDKのリストは、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

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

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

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

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

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