add-scrape-targetlisted
Install: claude install-skill sca-node-template/prometheus-template
# Add a scrape target
Follow the conventions in AGENTS.md. Microservice jobs (9101-9104) stay
commented until a real target exists.
## Steps
1. Configure the exporter or the service metrics endpoint (e.g. the JMX rules
in `kafka-connect-jmx.yml` for Kafka Connect).
2. Add or edit the job in `prometheus.yml`: `job_name`, `metrics_path`,
target and labels. Prometheus runs on the **host network**, so targets are
always `127.0.0.1:<published port>` — never `host.docker.internal` nor
`kafka-network` names (those are only for the exporters' own outbound
connections, not for scrape targets).
3. Register the service in Consul: add `name:port` to `SERVICES` in
`../consul/scripts/register-services.sh` and the name to `EXPECTED` in
`../consul/scripts/validate.sh` (TCP checks on `127.0.0.1:<port>`).
4. If a new host port appears, add it to `.env.example` and the compose file.
5. Update the README tables (ports, jobs, monitored services).
6. Run `make validate` and open a PR with the checklist from the template.