# Platform & Observability — Features

> Monitoring, logging, and performance tracking for edge-native apps.

Aerostack isn't just a development tool; it's a production-grade operations platform. We provide deep visibility into your edge functions, databases, and core primitives without any manual instrumentation.

## Built-in Visibility

Unlike traditional setups where you need to install agents (Datadog, New Relic), Aerostack's observability is **Native**. Every request is automatically traced and measured.

**Real-time Metrics** — Track P50, P95, and P99 latencies across all your endpoints. Monitor request volume and error rates in real-time.

**Distributed Tracing** — Follow a single request as it hits your API, queries the database, calls an AI model, and returns to the user.

---

## Log Management

Aerostack aggregates logs from all your edge functions into a single, searchable stream.

- **Real-time Tail**: Watch logs live via the Admin Panel or CLI (`aerostack logs --tail`).
- **Structured Search**: Filter by project, environment, user ID, or custom correlation keys.
- **AI-Powered Analysis**: Integrated LLMs analyze error spikes and suggest fixes based on your code context.

### Example Structured Log

```json
{
  "timestamp": "2024-03-20T10:00:00Z",
  "level": "ERROR",
  "project": "my-shop",
  "trace_id": "8870a9a6",
  "message": "Database connection timeout in hook 'beforeSignup'",
  "context": {
    "db_provider": "postgres",
    "region": "FRA"
  }
}
```

---

## Performance Guardrails

The platform automatically identifies and mitigates performance bottlenecks:

1.  **Cache Efficiency**: Visualizes your hit/miss ratio for `sdk.cache` calls.
2.  **Database Health**: Monitors long-running queries and suggests indexes via the **AI Assistant**.
3.  **Cold Start Tracking**: Measures the impact of worker isolation and code size on your response times.

---

## Security Observability

Every administrative action and security-sensitive event is logged in your **Audit Trail**.

- **API Key Usage**: Track which keys are being used and from where.
- **Permission Changes**: Detailed logs of who changed which project settings.
- **Rate Limit Hits**: Visualize where spike traffic is coming from.
