Skip to main content

Logging Architecture

Audience

This page is for developers and operators responsible for troubleshooting, audit, task tracing, and runtime governance.

Goal and Scope

This page separates logging, audit, and observability responsibilities.

Core Concepts

logging

logging is for diagnosis and runtime troubleshooting.

audit

audit is for security, accountability, and compliance.

observability

observability is for runtime health, metrics, and tracing.

Standard Workflow

A production mutation typically emits all three layers: logging, audit, and observability.

CLI Examples

aios app logs my-api --env prod

Web UI Path

  • platform logging view
  • audit center
  • task details with execution logs and state

Pitfalls / Risk Notes

  • audit is not just another application log stream
  • if task, approval, or installer events live only in memory, audit and replay guarantees fail