> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 日志架构

> AiOS 中 logging、audit、observability 的分层与状态外置要求。

# 日志架构

## 适用对象

本页面适用于负责排障、审计、任务追踪与平台运行治理的开发者和运维人员。

## 目标与范围

本页明确区分 logging、audit、observability 三类运行数据。

## 核心概念

### logging

用于排障和运行诊断，例如请求日志、服务错误日志、运行时告警。

### audit

用于安全、追责与合规，例如谁在什么环境执行了什么动作、是否触发审批、最终执行结果。

### observability

用于系统运行态观测，例如 metrics、tracing、health。

### Task 与 Approval 的关系

* Task 仍是长时执行的持久化跟踪模型，用于记录进度、状态与结果。
* Approval 仍是高风险动作的决策与审计记录，不替代 Task 的执行跟踪职责。

## 标准流程

一次生产变更通常会同时产生三层数据：logging、audit、observability。

## 规划中的 CLI 示例（尚未实现）

当前仓库尚未交付这个日志查询子命令；它只用于说明未来 CLI 也需要消费统一的日志与审计模型。

```bash theme={null}
aios app logs my-api --env prod
```

## Web UI 路径

* 平台日志视图
* 审计中心
* 任务详情中的执行日志与状态

## 常见问题 / 风险提示

* audit 不是普通日志子集，不能只靠应用日志代替。
* 如果任务/审批/安装事件只存在内存中，就无法满足审计和回放要求。
* 只保留 audit 记录而缺少 Task 执行跟踪，仍然不足以支撑长时工作回放与状态恢复。

## 相关页面

* [备份模型](/platform/backup-model)
* [认证与授权模型](/operations/authn-authz)