About

A comprehensive guide for collecting, and exporting telemetry data (metrics, logs, and traces) from Docker Swarm environment.

Important

This project is a work in progress and is not yet ready for production use. But feel free to test it and provide feedback.

• About
  • Stacks
    • Promstack
    • Logstack
  • Pre-requisites
  • Configure the Docker daemon to expose metrics for Prometheus

Stacks

These are the components that will be instrumented to gather Metrics, Logs and Traces.

• promstack: A Docker Stack deployment for the monitoring suite for Docker Swarm includes (Grafana, Prometheus, cAdvisor, Node exporter and Blackbox prober exporter)
• logstack: Like Promstack, but for logs. Includes (Grafana Loki and Promtail)

Promstack

A Docker Stack deployment for the monitoring suite for Docker Swarm includes (Grafana, Prometheus, Promtail, cAdvisor, Node exporter and Blackbox prober exporter)

• Automatically discover and scrape the metrics from the Docker Swarm nodes, services and tasks.
• Ability to configure scrape target via Docker object labels.
• Dynamically inject scrape configs from Docker configs.
• Automatically reload the Prometheus configuration when the Docker configs are create/update/remove.

The dynamic scrape configs are provided by the swarmlibs/prometheus-configs-provider service. And with the help of the prometheus-operator/prometheus-operator/tree/main/cmd/prometheus-config-reloader tool, we can automatically reload the Prometheus configuration when the Docker configs are create/update/remove.

See https://github.com/swarmlibs/promstack for more information.

Logstack

Like Promstack, but for logs. Includes (Grafana Loki and Promtail)

See https://github.com/swarmlibs/logstack for more information.

---

TBD