アクティビティ追跡イベント IBM Cloud Logs
標準プランとエンタープライズ・プランで、ユーザーおよびアプリケーションが IBM® Cloud Logs 内の Event Streams サービスとどのように対話するのかを IBM Cloud サービスを使用してトラッキングします。
IBM Cloud Logs サービスは、IBM Cloud 内のサービスの状態を変更するユーザー開始アクティビティーを記録します。 詳しくは、 IBM Cloud Logs のアクティビティ追跡イベントをご覧ください。
イベントは、CADF（Cloud Auditing Data Federation）標準に従ってフォーマットされる。 それらに含まれる情報の詳細については、 CADF 標準 を参照してください。
IBM Cloud® Activity Tracker Event Routing （プラットフォームサービス）を使用して、アクティビティトラッキングイベントの送信先を定義するターゲットとルートを設定することにより、 アカウント内の監査イベントを選択した送信先にルーティングすることができます。 詳しくは、IBM Cloud® Activity Tracker Event Routingを参照してください。
トピックのイベント
エンタープライズ・プランまたは標準プランにある Event Streams インスタンスは、トピック・イベントを自動的に生成します。
次の表に、トピックのイベントを示します。
| アクション | 説明 |
|---|---|
| event-streams.topic.create | トピックを作成するとイベントが作成される。 |
| event-streams.topic.delete | トピックを削除するとイベントが作成される。 |
| event-streams.topic.update | トピックの構成を更新したり、パーティションを増加したりすると、イベントが作成される。 |
トピック構成に関する追加情報は、更新イベントおよび削除イベント (パーティション、retentionMs、segmentMsなど) に記録されます。
メッセージ監査イベント
Enterprise plan の Event Streams インスタンスについて、トピックごとにメッセージ監査イベントを有効にすることができます。 また、
メッセージ監査イベントを有効にする方法も参照してください。
次の表に、メッセージ監査イベントを示します。
| アクション | 説明 |
|---|---|
| event-streams.message.read | イベントは、トピックでメッセージ監査が有効になっており、コンシューマがトピックからデータを読み込んでいるときに作成される。 |
| event-streams.message.write | メッセージ監査がトピック上で有効になっており、プロデューサがトピックにデータを書き込んでいるとき、イベントが作成される。 |
| event-streams.message.delete | トピックでメッセージ監査が有効になり、トピックからレコードが削除されると、イベントが作成されます。 保存ポリシーによるレコード削除は生成されません。 |
Event Streams は高いリクエストレートを維持できるので、すべてのリクエストがイベントをトリガーするわけではない。 その代わりに、イベントは、イニシエータ（ユーザーIDまたはサービスID）、ホスト（IPアドレス）、操作（読み取り、書き込み、削除）、結果（成功または失敗）、および1時間にわたるトピックごとに集約される。
その他のイベント
Enterprise plan の Event Streams インスタンスは、ユーザーがサービス上のアクティビティーを追跡できるように、イベントを自動的に生成します。
| アクション | 説明 |
|---|---|
| event-streams.storage-key.read | Key Protect 内のディスク暗号鍵へのアクセス権限が変更されると、イベントが作成されます。 このイベントの結果が success の場合、ディスク暗号化キーへのアクセスが復元され、 Event Streams インスタンスが使用可能になる。 結果が failure の場合、ディスク暗号化キーへのアクセスは取り消され、 Event Streams インスタンスは使用できなくなる。 |
| event-streams.storage-key.update | Key Protect のディスク暗号鍵がローテーションされ、新しい鍵を使用するように Event Streams インスタンスが更新されました。 |
| event-streams.schema.create | 管理 API または Confluent Serdes を介して、エンタープライズ・インスタンスの Event Streams スキーマ・レジストリーでスキーマまたはスキーマ・バージョンが作成または更新されました。 |
| event-streams.schema.delete | エンタープライズ・インスタンスの Event Streams スキーマ・レジストリーからスキーマまたはスキーマ・バージョンが削除されました。 |
| event-streams.schema-rule.create | エンタープライズ・インスタンスの Event Streams スキーマ・レジストリーに新規ルールまたはグローバル・ルールが作成されました。 |
| event-streams.schema-rule.update | エンタープライズ・インスタンスの Event Streams スキーマ・レジストリー内の既存のルールまたはグローバル・ルールが更新されました。 |
| event-streams.schema-rule.delete | エンタープライズ・インスタンスの Event Streams スキーマ・レジストリー内のルールが削除されました。 |
イベントを表示できる場所
アクティビティ追跡イベントは、イベントが発生した IBM Cloud の場所（地域）で利用可能な IBM Cloud Logs アカウントドメイン で利用可能です。
Event Streams サービスのインスタンスによって生成されたイベントは、同じ場所で使用可能な IBM Cloud Logs サービス・インスタンスに自動的に転送されます。
IBM Cloud Logs のインスタンスは、ロケーションごとに 1 つだけ作成できます。 イベントを表示するには、ご使用のサービス・インスタンスが使用可能なロケーションと同じ場所にある IBM Cloud Logs サービスの Web UI にアクセスする必要があります。 Cloud Logs UIを起動します。
メッセージ監査イベントを有効にする方法
メッセージ監査イベントは、トピックごとに有効にすることができます。 これを行うには、以下のステップを実行します。
-
Event Streams CLI プラグイン v2.3 以降をインストールします。
ibmcloud plugin install event-streams -
既存のトピックでメッセージ監査を有効にします。
ibmcloud es topic-update <topic-name> --config message.audit.enable=trueまたは、メッセージ監査を有効にして新しいトピックを作成します。
ibmcloud es topic-create <topic-name> --partitions <number-of-partitions> --config message.audit.enable=true
トピックのメッセージ監査構成が更新されると、約 5 分でメッセージ監査イベントが Activity Tracker に表示されます。
さらに、メッセージ監査イベントを有効にした場合の影響にも注意してください。
-
内部 Kafka トピックは、IBM Cloud Logs へのイベントのストリーミングに使用されるため、少量のクラスターのネットワーク帯域幅とストレージを使用します。 通常、スループットは 1 KB/ 秒未満であり、ストレージは 1 GB を超えません。
-
より多くのイベントが IBM Cloud Logs に送信されるため、メッセージ監査イベントを有効にすると、 IBM Cloud Logs に余分なストレージコストが発生する。 各イベントのサイズは約1KBである。100のトピックを持つクラスタの例では、各トピックに10クライアントがアクティブに生成と消費を行い、各クライアントが3つの異なるロケーションで実行されると、1時間あたり 100x10x3=3000、1ヶ月あたり合計2GBのイベントが生成される。