著作権: 年： 2017年、2024年 最終更新日"2024-06-11"
keywords: アクティビティトラッカー, LogDNA, イベント, オブジェクトストレージ, COS APIコール, COSイベント監視
サブコレクション: cloud object-storage
Activity Tracker イベント
IBM Cloud® Activity Tracker サービスを使用して、ユーザーとアプリケーションが IBM Cloud Object Storage (COS) とどのように対話するのかを追跡します。
この機能は現在、 Object Storage for Satelliteではサポートされていません。 詳細はこちらをご覧ください。
IBM Cloud Activity Tracker サービスは、IBM Cloud 内のサービスの状態を変更するユーザー開始アクティビティーを記録します。 詳細については、 IBM Cloud Activity Tracker を参照してください。
デフォルトでは、グローバル・アクション (バケットの作成など) について報告する COS イベントは自動的に収集されます。 グローバル・アクションは、フランクフルトのロケーションにある Activity Tracker インスタンスを介してモニターできます。
IBM Cloud Object Storage では、管理イベントおよび COS データ・イベントをモニターすることもできます。
- アカウント内のこれらのイベントの収集はオプションです。
- 管理イベントまたはデータ・イベント、あるいはその両方を有効にするには、各バケットを構成する必要があります。
- ユーザーがCOSリソース上で実行する各アクションは、
responseData.requestIdフィールドのイベントに含まれる一意のIDを持つ。
このサービスを使用して、異常なアクティビティーや重大なアクションがないかを調査し、規制監査要件を遵守することができます。 さらに、アクションが発生した際にそれに関するアラートを通知させるようにできます。 収集されるイベントは、Cloud Auditing Data Federation (CADF) 標準に準拠しています。
Object Storage で IBM Cloud® Activity Tracker を使用する方法については、 IBM Cloud Object Storage バケットでのイベントのトラッキング を参照してください。 以下に、使用可能なすべてのイベントをリストします。
管理イベント
管理イベントは、以下のカテゴリーに分類されます。
- グローバル・イベント
- リソース構成イベント
- バケット・イベント
- オブジェクト・イベント
グローバル・イベント
次の表に、グローバル・イベントを生成する COS アクションを示します。 このイベントは、フランクフルトのロケーションにある Activity Tracker インスタンスを介してモニターできます。
| アクション | 説明 |
|---|---|
cloud-object-storage.instance.list |
サービス・インスタンス内のバケットのリスト |
cloud-object-storage.bucket.create |
サービス・インスタンス内のバケットの作成 |
cloud-object-storage.bucket.delete |
サービス・インスタンス内のバケットの削除 |
cloud-object-storage.backup-vault.list |
サービスインスタンスのバックアップ保管庫をリストアップする |
cloud-object-storage.backup-vault.create |
サービスインスタンスにバックアップ保管庫を作成する |
cloud-object-storage.backup-vault.delete |
サービスインスタンスのバックアップ保管庫を削除する |
リソース構成イベント
次の表に、COS リソース構成イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.resource-configuration.read |
バケットのリソース構成の読み取り |
cloud-object-storage.resource-configuration.update |
バケットのリソース構成の更新 |
cloud-object-storage.bucket-backup-policy.create |
バケットにバックアップポリシーを作成する |
cloud-object-storage.bucket-backup-policy.read |
バケットのバックアップポリシーを読む |
cloud-object-storage.bucket-backup-policy.list |
バケット上のすべてのバックアップポリシーをリストする |
cloud-object-storage.bucket-backup-policy.delete |
バケットのバックアップポリシーを削除する |
| アクション | 説明 |
|---|---|
cloud-object-storage.resource-configuration.read |
バケットのリソース構成の読み取り |
cloud-object-storage.resource-configuration.update |
バケットのリソース構成の更新 |
cloud-object-storage.bucket-backup-policy.create |
バケットにバックアップポリシーを作成する |
cloud-object-storage.bucket-backup-policy.read |
バケットのバックアップポリシーを読む |
cloud-object-storage.bucket-backup-policy.list |
バケット上のすべてのバックアップポリシーをリストする |
cloud-object-storage.bucket-backup-policy.delete |
バケットのバックアップポリシーを削除する |
| アクション | 説明 |
|---|---|
cloud-object-storage.backup-vault-configuration.read |
バックアップ保管庫の設定を読む |
cloud-object-storage.backup-vault-configuration.update |
バックアップ保管庫の設定を更新する |
cloud-object-storage.backup-recovery-range.read |
回復範囲に関する情報を読む |
cloud-object-storage.backup-recovery-range.list |
バックアップ保管庫内のリカバリ範囲を一覧表示 |
cloud-object-storage.backup-restore.create |
新しいリストア操作を作成する |
cloud-object-storage.backup-restore.list |
バックアップ保管庫のすべてのリストア操作 |
cloud-object-storage.backup-restore.read |
回復範囲を見る |
cloud-object-storage.backup-recovery-range.create |
新しい回復範囲を作成する |
cloud-object-storage.backup-recovery-range.update |
回復範囲の設定を更新する |
バケット・イベント
次の表に、COS バケット・イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.bucket-cors.read |
CORS 構成の取得 |
cloud-object-storage.bucket-cors.create |
CORS 構成の作成 |
cloud-object-storage.bucket-cors.delete |
CORS 構成の削除 |
cloud-object-storage.bucket-lifecycle.read |
バケットのライフサイクル構成の取得 |
cloud-object-storage.bucket-lifecycle.create |
バケットのライフサイクル構成の作成 |
cloud-object-storage.bucket-lifecycle.delete |
バケットのライフサイクル構成の削除 |
cloud-object-storage.bucket-acl.read |
バケット ACLルールを使用してサブネットのインバウンド・トラフィックおよびアウトバウンド・トラフィックをステートレスに管理するリスト。 アクセス制御リストは、サブネット・レベルでセキュリティーを提供するのに役立ちます。 を取得します。 |
cloud-object-storage.bucket-acl.create |
バケット ACLルールを使用してサブネットのインバウンド・トラフィックおよびアウトバウンド・トラフィックをステートレスに管理するリスト。 アクセス制御リストは、サブネット・レベルでセキュリティーを提供するのに役立ちます。 を作成します。 |
cloud-object-storage.bucket-crn.read |
バケット CRN の取得 |
cloud-object-storage.bucket-location.read |
バケットのロケーションの取得 |
cloud-object-storage.bucket-retention.read |
バケット保存の取得 |
cloud-object-storage.bucket-retention.create |
バケット保存の作成 |
cloud-object-storage.bucket-key-state.update |
Key Protect ルート暗号化キーの更新 |
cloud-object-storage.bucket-public-access-block.create |
パブリック ACL ブロック構成の追加 |
cloud-object-storage.bucket-public-access-block.read |
パブリック ACL ブロック構成の読み取り |
cloud-object-storage.bucket-public-access-block.delete |
パブリック ACL ブロック構成の削除 |
cloud-object-storage.bucket-key-state.update イベントの場合、以下のフィールドに追加情報が含まれます。
| フィールド | 説明 |
|---|---|
requestData.eventType |
発生したライフサイクル・イベントのタイプ (削除やローテーションなど) |
requestData.requestedKeyState |
要求された鍵の状態 (使用可能または使用不可)。 |
requestData.requestKeyVersion |
要求されたバージョンの鍵。 |
requestData.bucketLocation |
このキーを使用するバケットのロケーション。 |
responseData.eventID |
キー・ライフサイクル・イベントに関連付けられている固有 ID。 |
responseData.adopterKeyState |
鍵の現在の状態 (使用可能または使用不可)。 |
responseData.adopterKeyVersion |
鍵の現在のバージョン。 |
オブジェクト・イベント
次の表に、COS オブジェクト・イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.object-cors.read |
CORS 構成の取得 |
cloud-object-storage.object-acl.read |
オブジェクト ACL の取得 |
cloud-object-storage.object-acl.create |
オブジェクト ACL の作成 |
cloud-object-storage.object-retention-legal-hold.list |
オブジェクトの訴訟ホールドのリスト |
cloud-object-storage.object-retention-legal-hold.update |
オブジェクトの訴訟ホールドの追加または削除 |
cloud-object-storage.object-retention.update |
保存期間の延長 |
cloud-object-storage.object-expire.read |
オブジェクトがいつ期限切れになるのかを取得 |
データ・イベント
データ・イベントは、以下のカテゴリーに分類されます。
- バケット・アクセス・イベント
- オブジェクト・アクセス・イベント
- マルチパート・イベント
- バケットのバージョン管理イベント
バケット・アクセス・イベント
次の表に、COS バケット・アクセス・イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.bucket.list |
バケット内のオブジェクトのリスト |
cloud-object-storage.bucket-metadata.read |
バケットのメタデータの取得 |
オブジェクト・アクセス・イベント
次の表に、COS オブジェクト・アクセス・イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.object-metadata.read |
オブジェクトのメタデータの取得 |
cloud-object-storage.object.read |
オブジェクトの読み取り |
cloud-object-storage.object.create |
オブジェクトの作成 |
cloud-object-storage.object.delete |
オブジェクトの削除 |
cloud-object-storage.objects.delete |
複数のオブジェクトの削除 |
cloud-object-storage.object-batch.delete |
バッチでのオブジェクトの削除 |
cloud-object-storage.object-copy.read |
コピーするソース・オブジェクトの読み取り |
cloud-object-storage.object-copy.create |
コピーからのターゲット・オブジェクトの作成 |
cloud-object-storage.object-restore.read |
リストアするソース・オブジェクトの読み取り |
cloud-object-storage.object-restore.create |
リストアからのターゲット・オブジェクトの作成 |
cloud-object-storage.backup-restore.object-create |
バックアップ・リストア操作でオブジェクトを作成する |
バケットのバージョン管理が有効になっている場合、オブジェクト・バージョンを使用する操作には target.versionId が存在します。
cloud-object-storage.object.delete イベントおよび cloud-object-storage.object-batch.delete イベントの場合、以下のフィールドに追加情報が含まれます。
| フィールド | 説明 |
|---|---|
responseData.deleteMarker.created |
オブジェクトはバージョン管理され、削除マーカーに置き換えられました。 |
マルチパート・イベント
次の表に、COS マルチパート・イベントを示します。
| アクション | 説明 |
|---|---|
cloud-object-storage.bucket-multipart.list |
バケット内のオブジェクトのマルチパート・アップロードのリスト |
cloud-object-storage.object-multipart.list |
オブジェクトのパートのリスト |
cloud-object-storage.object-multipart.start |
オブジェクトのマルチパート・アップロードの開始 |
cloud-object-storage.object-multipart.create |
オブジェクトのマルチパート・アップロードのパートの作成 |
cloud-object-storage.object-multipart.complete |
オブジェクトのマルチパート・アップロードの完了 |
cloud-object-storage.object-multipart.delete |
オブジェクトの不完全なマルチパートのアップロードを中止する |
バケットのバージョン管理イベント
次の表は、COSのバージョン管理イベントの一覧である：
| アクション | 説明 |
|---|---|
cloud-object-storage.bucket-versioning.create |
バケットのバージョン管理を有効にする |
cloud-object-storage.bucket-versioning.read |
バケットのバージョン管理状況の確認 |
cloud-object-storage.bucket-versioning.list |
バケツ内のオブジェクトのバージョンをリストする |
cloud-object-storage.bucket-versioning.create イベントの場合、以下のフィールドに追加情報が含まれます。
| フィールド | 説明 |
|---|---|
requestData.newValue.versioning.state |
バケットのバージョン管理状態 (使用可能または中断)。 |
イベントの表示
Object Storage インスタンスに関連付けられている Activity Tracker イベントを表示するには、次のようにします。 IBM Cloud Activity Tracker.
プロビジョンできる IBM Cloud Activity Tracker サービスのインスタンスはロケーションごとに 1 つのみです。
イベントを表示するには、イベントが収集される、モニタリングに使用可能なロケーションを識別する必要があります。 その後、そのロケーションにある IBM Cloud Activity Tracker インスタンスの Web UI にアクセスする必要があります。 詳しくは、IBM Cloud UI を介して Web UI を起動するを参照してください。
管理イベント
Object Storage グローバル・イベントは、フランクフルトに置かれている IBM Cloud Activity Tracker サービス・インスタンスに転送されます。
その他のすべての Object Storage 管理イベントは、バケツに関連する IBM Cloud Activity Tracker インスタンスに転送される。
イベントを表示するには、バケットに関連付けられたロケーションにある IBM Cloud Activity Tracker インスタンスの Web UI にアクセスする必要があります。
データ・イベント
Object Storage データ・イベントは、バケットに関連付けられた IBM Cloud Activity Tracker インスタンスに転送されます。
イベントを表示するには、バケットに関連付けられたロケーションにある IBM Cloud Activity Tracker インスタンスの Web UI にアクセスする必要があります。
イベントの分析
イベントを生成する COS インスタンス ID の識別
IBM Cloud では 1 つ以上の COS インスタンスを持つことができます。
イベントを生成したアカウント内の COS インスタンス ID をすばやく特定するには、 responseData フィールドに設定されているフィールド responseData.serviceInstanceId をチェックします。
バケット・ロケーションの識別
バケツの場所を素早く特定するには、 responseData フィールドに設定されているフィールド responseData.bucketLocation をチェックします。
要求の固有 ID の取得
ユーザーが COS リソースに対して実行する各アクションには、固有の ID があります。
COSリソースへのリクエストの一意なIDを取得するには、 responseData フィールドに設定されているフィールド responseData.requestId をチェックする。
マルチパート・アップロード操作のすべてのイベントの取得
1 つの大容量オブジェクトをマルチパート・アップロード操作を使用してアップロードすると、操作ごとに 1 つのイベントが生成されます。 各イベントにおいて、フィールド responseData.uploadId は同じ値に設定される。
マルチパート・アップロード操作の一部であるすべてのイベントを検索するには、特定の responseData.uploadId 値を検索します。
リストア要求に対して生成されるすべてのイベントの取得
アーカイブからオブジェクトをリストアする 1 つの要求によって、COS では以下のように複数のイベントが生成されます。
- ソース・オブジェクトの読み取りアクション。 このアクションは、アクション cloud-object-storage.object-restore.read のイベントを生成します。
- バケットへのオブジェクトの作成アクション。 このアクションは、アクション cloud-object-storage.object-restore.create のイベントを生成します。
responseData.requestId フィールドを使って、オブジェクトをリストアするときに発生するイベントを特定することができます。
あるバケットから別のバケットへのオブジェクトのコピーに対して生成されるすべてのイベントの取得
あるバケットから別のバケットへオブジェクトをコピーする 1 つの要求によって、COS では以下のように複数のイベントが生成されます。
- ソース・オブジェクトの読み取りアクション。 このアクションは、アクション cloud-object-storage.object-copy.read のイベントを生成します。
- 新規バケットへのオブジェクトの作成アクション。 このアクションは、アクション cloud-object-storage.object-copy.create のイベントを生成します。
複数のバケットにまたがる 1 つのコピー・アクションについて報告するすべてのイベントを収集およびモニターするには、イベントを収集してアカウント内の同じ Activity Tracker インスタンスに転送するように、各バケットを構成することを検討してください。
- 1 つのバケットで管理イベントおよびデータ・イベントの収集が有効になっていない場合、そのバケットに対するコピー・アクションを報告するイベントは受信されません。
- バケットごとに異なる Activity Tracker インスタンスを構成すると、1 つのインスタンスに 1 つのイベントがあり、別のインスタンスに他のイベントがあるというようになります。
responseData.requestId フィールドを使って、あるバケツから別のバケツにオブジェクトをコピーしたときに発生するイベントを特定することができます。
ファイアウォール更新の詳細の取得
バケットのファイアウォールを更新すると、 cloud-object-storage.resource-configuration.update イベントが生成されます。
変更内容の詳細を取得するには、 requestData フィールドに表示されるフィールド requestData.allowedIp、 requestData.deniedIp、および requestData.allowedNetworkTypes を確認します。