Observability
Logs
Mesh collects build, deploy, and runtime logs for every service, plus HTTP request logs from the edge. Read them in the console, through the API, or ask an AI agent to read them for you.
Log types
| Type | Contains |
|---|---|
| Build | Output of the image build. |
| Deploy | Startup, health checks, restarts, and draining. |
| Runtime | Your process's standard output and standard error. |
| HTTP | One line per public request through the edge, with method, path, and status. |
| Network | Network events the platform records for the service. |
In the console
Open a service, go to Deployments, and open a deployment. Filter by Build, Deploy, or Runtime, and search the lines. Logs follow the deployment live while it runs.
Through the API
curl "https://mesh.example.com/v1/services/$SERVICE_ID/logs?log_type=SERVICE_LOG_TYPE_RUNTIME&search=error&limit=200" \
-H "Authorization: Bearer $MESH_TOKEN"Results are paged with page tokens and can be bounded by time. The MCP server
offers get_logs, get_build_logs, and http_logs, and diagnose_service
gathers recent logs with deployment and build state in one call. See
MCP server.
Retention
Logs are kept for the platform's default retention period, set by your operator. Change it per project in Project settings → Log retention, from 1 to 90 days.