ログイベントスキーマ
イベントスキーマ
このスキーマはユーザー向けに提供されている監査ログ機能および Core システムと Agent システム間の連携のために使用されるスキーマです。
システムとしてのログは、shiron-about ページに記載されているシステムログに関する表記を参照してください。
ベーススキーマ
| propaty | type | description |
|---|---|---|
| id | int | 自動採番 |
| transaction_id | str | ulid 一連の動作で共通 |
| prefix | str | サービスプレフィックス |
| event_type | str | イベントタイプ |
| extra | json | イベントタイプごとそれぞれ定義されたスキーマを持つ |
| created_at | datetime | 記録された日時 |
イベントタイプ
shiron.Hub.Meta
Hub のメタデータに関するログ
method:
- Update
- Hub の情報が更新された
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Member
Hub に参加しているメンバー情報、または Hub のメンバーに紐づくオブジェクトに関するログ
method:
- Invite
- ユーザーが招待された
- Join
- ユーザーが参加した
- Remove
- ユーザーが削除された
- Leave
- ユーザーが離脱した
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| str | 操作対象のメールアドレス | |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Member.Role
Hub に参加しているメンバーに紐づくロールに関するログ
method:
- Add
- ロールが追加された
- Remove
- ロールが削除された
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| role_id | str | Role の固有 ID |
| role_name | str | 操作したロールの名称 |
| str | 操作対象のメールアドレス | |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Member.Sync
ユーザー同期
method:
-
Up
- 外部のデータソースから shiron に対して行われたユーザー同期 (ex. Entra ID → shiron)
-
Down
- shiron からエージェントに対して行われた(リクエストされた)ユーザー同期(ex. shiron → Discord)
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| platform | str | 連携したプラットフォーム |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Role
Hub 上のロール機能に関する操作
method:
- Add
- ロールの追加
- Remove
- ロールの削除
- Update
- ロールの更新
※ユーザーに対するロール操作は「shiron.Hub.Member.Role」で定義されています。
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| role_id | str | 操作したロールの固有 ID |
| role_name | str | 操作したロールの名称 |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Node
Node に関する操作
method:
- Add
- Node の追加
- Remove
- Node の削除
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| platform | str | Node のプラットフォーム |
| platform_id | str | Node のプラットフォーム ID |
| platform_name | str | Node のプラットフォームでの名前 |
| executer | str | 操作した人のメールアドレス |
shiron.Hub.Filter.Block
Hub に所属する Node 上のセキュリティ機能によってメッセージ投稿などがブロックされた場合のログ
method:
- Block
- 操作を強制的に中断した
- Warning
- 警告を行った
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| platform | str | Node のプラットフォーム |
| platform_id | str | Node のプラットフォーム ID |
| platform_name | str | Node のプラットフォームでの名前 |
| platform_user_id | str | Node のプラットフォーム上でのユーザー ID |
| platform_user_name | str | Node のプラットフォーム上でのユーザー名 |
| config_propaty | str | 検査を通らなかったプロパティ |
| config_message | str | メッセージ |
| content | str | 検査対象となったコンテンツ |
shiron.Hub.Filter.Config
フィルター機能の Config に関するログ
method:
- Create
- 作成された
- Update
- 更新された
- Delete
- 削除された
| propaty | type | desciption |
|---|---|---|
| hub_id | str | Hub の固有 ID |
| config_id | str or Node | Config の ID |
| executer | str | 操作した人のメールアドレス |