用户交互模型
实现可以自由地通过任何适合自身需求的界面模式公开日志; 协议本身并不强制规定任何特定的用户交互模型。能力
会发出日志消息通知的服务器 MUST 声明logging 能力:
日志级别
协议遵循 RFC 5424 中指定的标准 syslog 严重性级别:协议消息
设置日志级别
为了配置最低日志级别,客户端 MAY 发送logging/setLevel 请求:
请求:
日志消息通知
服务器使用notifications/message 通知发送日志消息:
消息流
错误处理
服务器 SHOULD 针对常见失败情况返回标准 JSON-RPC 错误:- 无效日志级别:
-32602(Invalid params) - 配置错误:
-32603(Internal error)
实现注意事项
-
服务器 SHOULD:
- 对日志消息进行速率限制
- 在 data 字段中包含相关上下文
- 使用一致的 logger 名称
- 移除敏感信息
-
客户端 MAY:
- 在 UI 中展示日志消息
- 实现日志筛选/搜索
- 以可视方式显示严重性
- 持久化日志消息
安全
-
日志消息 MUST NOT 包含:
- 凭据或密钥
- 个人身份识别信息
- 可能帮助攻击的内部系统细节
-
实现 SHOULD:
- 对消息进行速率限制
- 验证所有数据字段
- 控制日志访问
- 监控敏感内容