跳到主内容

条目

条目 是存储在Casdoor中的遥测记录。每个条目都包含有效载荷(OTLP 跟踪、指标、日志、操作系统日志记录或权限审计事件)以及关于发送方的元数据。

条目属性​

字段描述
名称组织内条目的唯一标识符
显示名称人类可读标签
提供商创建此条目的日志提供程序
类型trace、metrics、log、permission 或 system,具体取决于来源
Client IP发送者的IP地址(适用于通过HTTP接收的OTLP条目)
用户代理发送方的HTTP User-Agent(适用于通过HTTP接收的OTLP条目)
应用此条目所关联的Casdoor应用

OpenTelemetry 数据 (OTLP)​

Casdoor accepts all three OTLP signal types pushed by an OpenClaw agent:

端点存储类型条目类型
POST /api/v1/traces轨迹trace
POST /api/v1/metrics指标metrics
POST /api/v1/logs日志log

所有三个端点均需使用 Content-Type: application/x-protobuf。 OTLP protobuf 负载被序列化为 JSON,并存储在 Message 字段中。条目的 ClientIp 和 UserAgent 字段取自 HTTP 请求。

访问控制: 发件人的 IP 必须与同一组织中代理/OpenClaw 日志提供商的主机字段相匹配。来自未登记 IP 的请求会被拒绝,返回 403 Forbidden。将主机留空以允许任何 IP。

在条目编辑页面上,EntryMessageViewer 会将 trace 类型的条目渲染为带有时间、属性和状态的结构化跨度树。

权限审计日志​

当为组织配置了Casdoor权限日志提供程序时,Casdoor会为每次非GET API调用记录一条条目,其中包含主体、方法、URL,以及请求是被允许还是被拒绝。这些条目的 Type: permission,并通过 Provider 字段关联到创建它们的提供商。

管理条目​

在Casdoor侧栏中,导航至条目。每个条目都限定于一个组织。由提供商生成的条目会自动创建,且为只读。