跳到主内容

条目

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

条目属性

字段描述
名称组织内条目的唯一标识符
显示名称人类可读标签
提供商创建此条目的日志提供程序
类型tracemetricslogpermissionsystem,具体取决于来源
客户端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侧栏中,导航至条目。 每个条目都限定于一个组织。 由提供商生成的条目会自动创建,且为只读。