Stack init

Copies a five-component observability stack into observability/ in the repository and brings it up with docker compose. Alloy receives OTLP from the services and forwards metrics to Prometheus and logs to Loki. Prometheus scrapes targets, evaluates the alert rules and sends alerts to Alertmanager. Grafana reads all three through provisioned data sources and loads dashboards from files in git.

Inputs

• The repository: the current working directory, or a path the user names.
• The services to observe: for each, its name, and whether it serves /metrics (host and port) or sends OTLP.
• The teams that receive alerts, as short names (platform, app). The alert-routes skill uses them.
• Retention for metrics, logs and silences. Defaults: 30 days, 30 days, 120 hours.
• Where the stack runs: this machine only (default), or a host on the network.

Steps

1. Check the repository and the tools. Find the root with git rev-parse --show-toplevel. Run docker compose version and python3 --version (3.9 or later). If observability/ exists, list what is in it and ask before going on.
2. Copy without overwriting.