# NEXUS AI Observability

NEXUS AI exposes deployment logs, health, container metrics, usage statistics, and audit records through authenticated interfaces.

## Deployment signals

Agents can inspect deployment status, read build or runtime logs, query health, and read container metrics and metrics history. Health checks can be enabled or disabled and can target an HTTP path.

## Usage

The platform provides AI request counts, detailed usage statistics, and usage history. The MCP tool `nexusai_usage_stats` returns organization usage, quotas, and deployment counts.

## Audit

Audit logs record platform actions with actor identity, token name where applicable, timestamp, request context, and result. Audit routes include logs, event types, security summaries, security metrics, user activity, and CSV export for authorized organization administrators.

## Safety

Logs may contain application data. Do not paste secrets or credentials into logs, and restrict audit and usage access to the minimum required organization permission.

## Related resources

- [Deployment](/docs/deployment.md)
- [Security](/docs/security.md)
- [MCP tools](/mcp/tools.json)