イベント通知を有効にするには IBM® Storage Ceph® as a Service

IBM® Storage Ceph® as a Service の管理者として、 IBM Storage Ceph as a Service でのイベントに関する通知を、電子メール、SMS、またはその他のサポートされている配信チャネルを使用して、他のユーザーや個人宛てに送信したい場合があるかもしれません。 さらに、例えば、Webhookを使用したイベント・ドリブン・プログラミングを使用してロジックを作成するために、これらのイベント通知を他のアプリケーションに送信することもできます。 これは、 IBM® Storage Ceph® as a Service と IBM Cloud Event Notifications の連携によって実現されています。

Event Notifications に情報を送信するには、 IBM Storage Ceph のServiceインスタンスを Event Notifications に接続する必要があります。 Event Notifications の使用方法に関する詳細については、 「Event Notifications の入門 」を参照してください。

イベントがどのように収集・送信されるか IBM® Storage Ceph® as a Service

IBM Storage Ceph as a Service インスタンスで関心のあるイベントが発生すると、 IBM Storage Ceph as a Service は、接続された Event Notifications インスタンスと通信し、 サポートされている宛先に 通知を転送します。

IBM® Storage Ceph® as a Service のイベント

次の表には、 IBM Storage Ceph as a Service のイベントが一覧表示されています。

イベント通知を生成するアクション
イベント名 イベント・タイプ サブタイプ名 サブタイプ 重大度
IBM Storage Ceph サービスとしてのストレージ容量 com.ibm.cloud.software-defined-storage.capacity 容量の50%が割り当てられたブロックストレージ block_capacity_50_percent low
ブロックストレージの割り当て容量が80%に達しました block_capacity_80_percent ミディアム
ブロックストレージの割り当て容量が100%に達しています block_capacity_100_percent high
オブジェクトストレージの割り当て容量は、総容量の50%です object_capacity_50_percent low
割り当てられたオブジェクトストレージの容量使用率が80%に達しました object_capacity_80_percent ミディアム
割り当てられたオブジェクトストレージの容量使用率が100%に達しました object_capacity_100_percent high
IBM Storage Ceph as a Service S3 証明書 com.ibm.cloud.software-defined-storage.s3-certificate S3 証明書の有効期限が切れています s3_cert_expired high
S3 証明書の有効期限はあと1日で切れます s3_cert_expire_1_day high
S3 証明書の有効期限はあと10日で切れます s3_cert_expire_10_day high
S3 証明書の有効期限は30日後に切れます s3_cert_expire_30_day ミディアム
S3 証明書の有効期限はあと60日で切れます s3_cert_expire_60_day ミディアム
S3 証明書の有効期限は90日後に切れます s3_cert_expire_90_day low

通知を有効にしています

「 IBM Storage Ceph as a Service」のインスタンスによって生成されたイベントは、 アカウント利用可能な「 Event Notifications 」サービスインスタンスに転送することができます。 1つの Event Notifications サービスインスタンスに対して、 IBM Storage Ceph as a Serviceインスタンスを1つだけ設定できます。

コンソールから Event Notifications に接続する

「 IBM Storage Ceph as a Service」の通知を有効にする前に、「 IBM Storage Ceph as a Service」 アカウントと同じアカウント内に「 Event Notifications 」サービスインスタンスが存在することを確認してください。 その後、 IBM Storage Ceph as a Service の UI にある [ 設定] > [ Event Notifications ] セクションを使用して、各サービスを接続することができます。

  1. コンソールで、 ナビゲーションメニューアイコン ナビゲーションメニューアイコン をクリックし 、「リソース一覧」 を選択します。

  2. 「 IBM Storage Ceph as a Service」のインスタンスを選択してください。

  3. 「 IBM Storage Ceph as a Service」のナビゲーションで、「 設定」 をクリックします。

  4. Event Notifications セクションで、接続をクリックします。

  5. その接続のソースの詳細を確認してください。 オプションで、説明を入力します。

  6. 接続したいリソースグループと Event Notifications サービスインスタンスを選択してください。

    アカウント内に、 IBM Storage Ceph as a Service と Event Notifications 間の IAM 認証が存在しない場合、ダイアログが表示されます。 プロンプトに従って、サービス間のアクセス権限を付与します。

    1. 「 IBM Storage Ceph as a Service」と「 Event Notifications 」間のアクセス権を付与するには、「 承認」 をクリックしてください。
    2. 対象サービスとして Event Notifications をターゲットサービスとして選択します。
    3. インスタンスの一覧から、認証を行う Event Notifications サービスインスタンスを選択してください。
    4. **「イベント・ソース・マネージャー」**ロールを選択します。
    5. **「レビュー」**をクリックします。
    6. 割り当て をクリックします。
  7. 接続を確認するには、**「接続」**をクリックします。

選択した宛先に通知を配信しています

「 IBM Storage Ceph as a Service」の通知を有効にした後、 Event Notifications でトピックとサブスクリプションを作成し、アラートが選択した宛先に転送・配信されるようにしてください。

サポートされている宛先の完全な一覧については、『 Event Notifications 』のドキュメントを 参照してください。

E メール通知

IBM Cloud のメールサービスを、 IBM Storage Ceph as a Serviceのイベント通知の配信チャネルとして利用できます。 既存のトピックと IBM Cloud メールサービスとの間に Event Notifications サブスクリプションを作成し、アラートをさまざまな受信者にメールで転送するように設定します。

IBM Cloud から送信される、 IBM Storage Ceph as a Service イベントに関する情報が記載されたメールは、以下の例のような形式になっています

Subject: Replace S3 certificate (expires in 90 days)
Body: S3 certificate will expire in 90 days. Please replace your S3 certificate.

メールでイベント通知に関する詳細情報を受け取るには、 Event Notifications サブスクリプションを作成する際に、「 通知ペイロードを追加 」オプションを選択してください。 イベントに関連付けられた「通知ペイロードの詳細」が E メールに表示されます。

Webhook

着信通知をアプリまたはサービスによってプログラマチックにコンシュームするため、Webhookの配信先を構成できます。 Webhookの設定に関する詳細については、 Event Notifications のドキュメント をご覧ください。

通知ペイロードの詳細

IBM Storage Ceph as a Service によって生成される成功イベントには、イベントの発生元や詳細を特定するのに役立つさまざまなフィールドが含まれています。

IBM Storage Ceph as a Service からのイベント通知には、リソースの名前や識別子などのメタデータプロパティのみが含まれます。 APIキーやパスワードなどの機密データは、生成されるイベントには含まれません。

Event Notifications に送信されるプロパティは、イベントの種類によって異なります。 たとえば、 S3 の証明書失効イベントが発生した場合、 IBM Storage Ceph as a Serviceは、次のような通知ペイロードを Event Notifications に送信します。

{
    "ibmendefaultlong": "S3 certificate will expire in 90 days. Please replace your S3 certificate.",
    "ibmendefaultshort": "Replace S3 certificate (expires 90 days)",
    "ibmenseverity": "low",
    "ibmensourceid": "crn:v1:staging:public:software-defined-storage:satloc_dal_crmid4v20tl6u8usf790:a/3faf73b8d12b47fa6ce87494f8ae7686:0c81f602-5142-4809-9e42-31de8453416a::",
    "id": "38eb4721-db9b-4ba6-a5e7-cdd9cce66763",
    "source": "crn:v1:staging:public:software-defined-storage:satloc_dal_crmid4v20tl6u8usf790:a/3faf73b8d12b47fa6ce87494f8ae7686:0c81f602-5142-4809-9e42-31de8453416a::",
    "specversion": "1.0",
    "time": "2025-04-23T21:13:44.301Z",
    "type": "com.ibm.cloud.software-defined-storage.s3-certificate:s3_cert_expire_90_day"
}

イベント通知のプロパティに関する詳細については、次の表を参照してください。

イベント通知のペイロードに含まれるプロパティ
プロパティー (Property) 説明
ibmendefaultlong このメッセージは、人間が読み取れるテキストを必要とする宛先にイベントがルーティングされたものの、宛先固有の属性が指定されていない場合に使用されます。
ibmendefaultshort このメッセージは、人間が読み取れるテキストを必要とする宛先にイベントがルーティングされたものの、宛先固有の属性が指定されていない場合に使用されます。
ibmenseverity イベントの重大度。
ibmensourceid これは、 Event Notifications で作成されたソースのIDです。 これは、 Event Notifications のUIにある「ソース」セクションで確認できます。
id 各イベントを識別するための一意の識別子。
source これは、イベントプロデューサー(つまり、 IBM Storage Ceph as a Service の CRN)の識別子です。
specversion これは、 Event Notifications が現在サポートしているCloud Events仕様のバージョンです。 この値は「 1.0 」に設定する必要があります。
time イベントが発生した時点のUTCタイムスタンプ。 RFC 3339 形式でなければなりません。
type これは、イベントのタイプを記述します。 その形式は、 <event-type-name>:<sub-type> です。