条目
条目 是存储在Casdoor中的遥测记录。 每个条目都包含有效载荷(OTLP 跟踪、指标、日志、操作系统日志记录或权限审计事件)以及关于发送方的元数据。
条目属性
| 字段 | 描述 |
|---|---|
| 名称 | 组织内条目的唯一标识符 |
| 显示名称 | 人类可读标签 |
| 提供商 | 创建此条目的日志提供程序 |
| 类型 | trace、metrics、log、permission 或 system,具体取决于来源 |
| 客户端IP | 发送者的IP地址(适用于通过HTTP接收的OTLP条目) |
| 用户代理 | 发送方的HTTP User-Agent(适用于通过HTTP接收的OTLP条目) |
| 应用 | 此条目所关联的Casdoor应用 |
OpenTelemetry 数据 (OTLP)
Casdoor 接受 OpenClaw 代理推送的三种 OTLP 信号类型:
| 端点 | 存储类型 | 条目类型 |
|---|---|---|
POST /api/v1/traces | 轨迹 | 跟踪 |
POST /api/v1/metrics | 指标 | 指标 |
POST /api/v1/logs | 日志 | 日志 |
所有三个端点均需使用 Content-Type: application/x-protobuf。 OTLP protobuf 负载被序列化为 JSON,并存储在 Message 字段中。 条目的“ClientIp”和“UserAgent”字段会从 HTTP 请求中填充。
访问控制: 发件人的 IP 必须与同一组织中代理/OpenClaw 日志提供商的主机字段相匹配。 来自未识别 IP 的请求将被拒绝,并返回 403 禁止。 将主机留空以允许任何 IP。
在条目编辑页面上,EntryMessageViewer 会将 trace 类型的条目渲染为带有时间、属性和状态的结构化跨度树。
权限审计日志
当为组织配置了Casdoor权限日志提供程序时,Casdoor会为每次非GET API调用记录一条条目,其中包含主体、方法、URL,以及请求是被允许还是被拒绝。 这些条目具有“类型:权限”属性,并通过“提供商”字段链接到创建它们的提供商。
管理条目
在Casdoor侧栏中,导航至条目。 每个条目都限定于一个组织。 由提供商生成的条目会自动创建,且为只读。