Prometheus ArchitectureΒΆ

Compose 🐳¢

flowchart LR
    subgraph role [web-app-prometheus]
        svc_prometheus["prometheus<br>prom/prometheus:v3.16.0<br>http 9090"]
        svc_blackbox_exporter["blackbox-exporter<br>prom/blackbox-exporter:v0.29.1<br>http 9115"]
        svc_alertmanager["alertmanager<br>prom/alertmanager:v0.34.2<br>http 9093"]
        svc_cadvisor["cadvisor<br>gcr.io/cadvisor/cadvisor:v0.55.1<br>http 8080"]
        svc_node_exporter["node-exporter<br>prom/node-exporter:v1.12.1<br>http 9100"]
        svc_prometheusmcp["prometheusmcp<br>python:3.13.15-slim<br>http 8080"]
    end

Swarm 🐝¢

flowchart LR
    svc_prometheus["prometheus"]
    svc_prometheus --> rep_prometheus["replicas: from the host group"]
    svc_prometheus --> plc_prometheus["node.role == manager"]:::pinned
    svc_blackbox_exporter["blackbox-exporter"]
    svc_blackbox_exporter --> rep_blackbox_exporter["replicas: from the host group"]
    svc_blackbox_exporter --> plc_blackbox_exporter["node.role == manager"]:::pinned
    svc_alertmanager["alertmanager"]
    svc_alertmanager --> rep_alertmanager["replicas: from the host group"]
    svc_alertmanager --> plc_alertmanager["node.role == manager"]:::pinned
    svc_cadvisor["cadvisor"]
    svc_cadvisor --> rep_cadvisor["replicas: from the host group"]
    svc_cadvisor --> plc_cadvisor["node.role == manager"]:::pinned
    svc_node_exporter["node-exporter"]
    svc_node_exporter --> rep_node_exporter["replicas: from the host group"]
    svc_node_exporter --> plc_node_exporter["node.role == manager"]:::pinned
    svc_prometheusmcp["prometheusmcp"]
    svc_prometheusmcp --> rep_prometheusmcp["replicas: from the host group"]
    svc_prometheusmcp --> plc_prometheusmcp["node.role == manager"]:::pinned
    classDef pinned fill:#fef7e0,stroke:#b06000,color:#3d2600;

VolumesΒΆ

flowchart LR
    vol_data["prometheus_data"]
    vol_data -->|"role is manager-pinned"| local_data["node-local on the manager"]:::local
    vol_alertmanager_data["prometheus_alertmanager_data"]
    vol_alertmanager_data -->|"role is manager-pinned"| local_alertmanager_data["node-local on the manager"]:::local
    classDef shared fill:#e6f4ea,stroke:#137333,color:#0b2e13;
    classDef local fill:#fef7e0,stroke:#b06000,color:#3d2600;

Condition

Effect

swarm, storage.backend: nfs, no nfs: false, role not pinned

shared over NFS

any one of those missing

node-local

All four conditions must hold, so pinning a role takes every one of its volumes node-local. Only the role’s primary entry counts as pinned here: a placement on any other service pins that service alone and leaves the backing of every volume unchanged. The chain is drawn rather than its result, because that coupling is what makes a placement change move data without saying so.

DependenciesΒΆ

flowchart LR
    subgraph deps [Dependencies]
        dep_svc_bkp_volume_2_local["svc-bkp-volume-2-local πŸ’»"]
        dep_svc_net_tor["svc-net-tor 🐳🐝"]
        dep_web_app_dashboard["web-app-dashboard 🐳🐝"]
        dep_web_app_docs["web-app-docs 🐳🐝"]
        dep_web_app_flowise["web-app-flowise 🐳🐝"]
        dep_web_app_hermes["web-app-hermes 🐳🐝"]
        dep_web_app_keycloak["web-app-keycloak 🐳🐝"]
        dep_web_app_matomo["web-app-matomo 🐳🐝"]
        dep_web_app_openclaw["web-app-openclaw 🐳🐝"]
        dep_web_app_openwebui["web-app-openwebui 🐳🐝"]
        dep_web_app_stalwart["web-app-stalwart 🐳🐝"]
        dep_web_svc_design["web-svc-design πŸ’»"]
        dep_web_svc_logout["web-svc-logout 🐳🐝"]
    end
    subgraph role [web-app-prometheus 🐳🐝]
        svc_sso["sso"]
        svc_logout["logout"]
        svc_dashboard["dashboard"]
        svc_matomo["matomo"]
        svc_email["email"]
        svc_design["design"]
        svc_javascript["javascript"]
        svc_prometheus["prometheus"]
        svc_alertmanager["alertmanager"]
        svc_blackbox_exporter["blackbox-exporter"]
        svc_cadvisor["cadvisor"]
        svc_node_exporter["node-exporter"]
        svc_tor["tor"]
        svc_container_backup["container_backup"]
        svc_prometheusmcp["prometheusmcp"]
        svc_openwebui["openwebui"]
        svc_hermes["hermes"]
        svc_openclaw["openclaw"]
        svc_flowise["flowise"]
        svc_docs["docs"]
    end
    subgraph dependents [Dependents]
        dpt_web_app_akaunting["web-app-akaunting 🐳🐝"]
        dpt_web_app_baserow["web-app-baserow 🐳🐝"]
        dpt_web_app_bigbluebutton["web-app-bigbluebutton 🐳🐝"]
        dpt_web_app_bluesky["web-app-bluesky 🐳🐝"]
        dpt_web_app_bookwyrm["web-app-bookwyrm 🐳🐝"]
        dpt_web_app_bridgy_fed["web-app-bridgy-fed 🐳🐝"]
        dpt_web_app_checkmk["web-app-checkmk 🐳🐝"]
        dpt_web_app_chess["web-app-chess 🐳🐝"]
        dpt_web_app_confluence["web-app-confluence 🐳🐝"]
        dpt_web_app_dashboard["web-app-dashboard 🐳🐝"]
        dpt_web_app_decidim["web-app-decidim 🐳🐝"]
        dpt_web_app_discourse["web-app-discourse 🐳🐝"]
        dpt_web_app_docs["web-app-docs 🐳🐝"]
        dpt_web_app_erpnext["web-app-erpnext 🐳🐝"]
        dpt_web_app_espocrm["web-app-espocrm 🐳🐝"]
        dpt_web_app_fediwall["web-app-fediwall 🐳🐝"]
        dpt_web_app_fider["web-app-fider 🐳🐝"]
        dpt_web_app_flowise["web-app-flowise 🐳🐝"]
        dpt_web_app_friendica["web-app-friendica 🐳🐝"]
        dpt_web_app_funkwhale["web-app-funkwhale 🐳🐝"]
        dpt_web_app_fusiondirectory["web-app-fusiondirectory 🐳🐝"]
        dpt_web_app_gitea["web-app-gitea 🐳🐝"]
        dpt_web_app_gitlab["web-app-gitlab 🐳🐝"]
        dpt_web_app_hermes["web-app-hermes 🐳🐝"]
        dpt_web_app_homeassistant["web-app-homeassistant 🐳🐝"]
        dpt_web_app_hugo["web-app-hugo 🐳🐝"]
        dpt_web_app_jellyfin["web-app-jellyfin 🐳🐝"]
        dpt_web_app_jenkins["web-app-jenkins 🐳🐝"]
        dpt_web_app_jira["web-app-jira 🐳🐝"]
        dpt_web_app_jitsi["web-app-jitsi 🐳🐝"]
        dpt_web_app_joomla["web-app-joomla 🐳🐝"]
        dpt_web_app_keycloak["web-app-keycloak 🐳🐝"]
        dpt_web_app_kix["web-app-kix 🐳🐝"]
        dpt_web_app_lam["web-app-lam 🐳🐝"]
        dpt_web_app_listmonk["web-app-listmonk 🐳🐝"]
        dpt_web_app_litellm["web-app-litellm πŸ’»"]
        dpt_web_app_littlejs["web-app-littlejs 🐳🐝"]
        dpt_web_app_magento["web-app-magento 🐳🐝"]
        dpt_web_app_mailu["web-app-mailu 🐳🐝"]
        dpt_web_app_mastodon["web-app-mastodon 🐳🐝"]
        dpt_web_app_matomo["web-app-matomo 🐳🐝"]
        dpt_web_app_matrix["web-app-matrix 🐳🐝"]
        dpt_web_app_mattermost["web-app-mattermost 🐳🐝"]
        dpt_web_app_mediawiki["web-app-mediawiki 🐳🐝"]
        dpt_web_app_meta["web-app-meta 🐳🐝"]
        dpt_web_app_mini_qr["web-app-mini-qr 🐳🐝"]
        dpt_web_app_minio["web-app-minio 🐳🐝"]
        dpt_web_app_mobilizon["web-app-mobilizon 🐳🐝"]
        dpt_web_app_moodle["web-app-moodle 🐳🐝"]
        dpt_web_app_n8n["web-app-n8n 🐳🐝"]
        dpt_web_app_navigator["web-app-navigator 🐳🐝"]
        dpt_web_app_nextcloud["web-app-nextcloud 🐳🐝"]
        dpt_web_app_odoo["web-app-odoo 🐳🐝"]
        dpt_web_app_openbao["web-app-openbao 🐳🐝"]
        dpt_web_app_openclaw["web-app-openclaw 🐳🐝"]
        dpt_web_app_opencloud["web-app-opencloud 🐳🐝"]
        dpt_web_app_openproject["web-app-openproject 🐳🐝"]
        dpt_web_app_opentalk["web-app-opentalk 🐳🐝"]
        dpt_web_app_openwebui["web-app-openwebui 🐳🐝"]
        dpt_web_app_peertube["web-app-peertube 🐳🐝"]
        dpt_web_app_penpot["web-app-penpot 🐳🐝"]
        dpt_web_app_pgadmin["web-app-pgadmin 🐳🐝"]
        dpt_web_app_phpldapadmin["web-app-phpldapadmin 🐳🐝"]
        dpt_web_app_phpmyadmin["web-app-phpmyadmin 🐳🐝"]
        dpt_web_app_pihole["web-app-pihole 🐳"]
        dpt_web_app_pixelfed["web-app-pixelfed 🐳🐝"]
        dpt_web_app_postmarks["web-app-postmarks 🐳🐝"]
        dpt_web_app_pretix["web-app-pretix 🐳🐝"]
        dpt_web_app_roulette_wheel["web-app-roulette-wheel 🐳🐝"]
        dpt_web_app_seaweedfs["web-app-seaweedfs 🐳🐝"]
        dpt_web_app_semaphore["web-app-semaphore 🐳🐝"]
        dpt_web_app_shopware["web-app-shopware 🐳🐝"]
        dpt_web_app_snipe_it["web-app-snipe-it 🐳🐝"]
        dpt_web_app_socialhome["web-app-socialhome 🐳🐝"]
        dpt_web_app_stalwart["web-app-stalwart 🐳🐝"]
        dpt_web_app_suitecrm["web-app-suitecrm 🐳🐝"]
        dpt_web_app_taiga["web-app-taiga 🐳🐝"]
        dpt_web_app_wazuh["web-app-wazuh 🐳🐝"]
        dpt_web_app_weblate["web-app-weblate 🐳🐝"]
        dpt_web_app_wordpress["web-app-wordpress 🐳🐝"]
        dpt_web_app_xwiki["web-app-xwiki 🐳🐝"]
        dpt_web_app_yourls["web-app-yourls 🐳🐝"]
        dpt_web_app_zammad["web-app-zammad 🐳🐝"]
        dpt_web_svc_api["web-svc-api 🐳🐝"]
        dpt_web_svc_asset["web-svc-asset πŸ’»"]
        dpt_web_svc_cdn["web-svc-cdn πŸ³πŸπŸ’»"]
        dpt_web_svc_collabora["web-svc-collabora 🐳🐝"]
        dpt_web_svc_coturn["web-svc-coturn 🐳🐝"]
        dpt_web_svc_design["web-svc-design πŸ’»"]
        dpt_web_svc_file["web-svc-file πŸ’»"]
        dpt_web_svc_html["web-svc-html πŸ’»"]
        dpt_web_svc_legal["web-svc-legal 🐳🐝"]
        dpt_web_svc_libretranslate["web-svc-libretranslate 🐳🐝"]
        dpt_web_svc_logout["web-svc-logout 🐳🐝"]
        dpt_web_svc_mirror["web-svc-mirror πŸ’»"]
        dpt_web_svc_onlyoffice["web-svc-onlyoffice 🐳🐝"]
        dpt_web_svc_s1["web-svc-s1 πŸ’»"]
        dpt_web_svc_seaweedfs["web-svc-seaweedfs 🐳🐝"]
        dpt_web_svc_simpleicons["web-svc-simpleicons 🐳🐝"]
        dpt_web_svc_translate["web-svc-translate 🐳🐝"]
        dpt_web_svc_xmpp["web-svc-xmpp 🐳🐝"]
    end
    dep_svc_bkp_volume_2_local -. "0..1" .-> svc_container_backup
    dep_svc_net_tor -. "0..1" .-> svc_tor
    dep_web_app_dashboard -. "0..1" .-> svc_dashboard
    dep_web_app_docs -. "0..1" .-> svc_docs
    dep_web_app_flowise -. "0..1" .-> svc_flowise
    dep_web_app_hermes -. "0..1" .-> svc_hermes
    dep_web_app_keycloak -. "0..1" .-> svc_sso
    dep_web_app_matomo -. "0..1" .-> svc_matomo
    dep_web_app_openclaw -. "0..1" .-> svc_openclaw
    dep_web_app_openwebui -. "0..1" .-> svc_openwebui
    dep_web_app_stalwart -. "0..1" .-> svc_email
    dep_web_svc_design -. "0..1" .-> svc_design
    dep_web_svc_logout -. "0..1" .-> svc_logout
    svc_sso -. "0..1" .-> dpt_web_app_akaunting
    svc_sso -. "0..1" .-> dpt_web_app_baserow
    svc_sso -. "0..1" .-> dpt_web_app_bigbluebutton
    svc_sso -. "0..1" .-> dpt_web_app_bluesky
    svc_sso -. "0..1" .-> dpt_web_app_bookwyrm
    svc_sso -. "0..1" .-> dpt_web_app_bridgy_fed
    svc_sso -. "0..1" .-> dpt_web_app_checkmk
    svc_sso -. "0..1" .-> dpt_web_app_chess
    svc_sso -. "0..1" .-> dpt_web_app_confluence
    svc_sso -. "0..1" .-> dpt_web_app_dashboard
    svc_sso -. "0..1" .-> dpt_web_app_decidim
    svc_sso -. "0..1" .-> dpt_web_app_discourse
    svc_sso -. "0..1" .-> dpt_web_app_docs
    svc_sso -. "0..1" .-> dpt_web_app_erpnext
    svc_sso -. "0..1" .-> dpt_web_app_espocrm
    svc_sso -- "1:1" --> dpt_web_app_fediwall
    svc_sso -. "0..1" .-> dpt_web_app_fider
    svc_sso -. "0..1" .-> dpt_web_app_flowise
    svc_sso -. "0..1" .-> dpt_web_app_friendica
    svc_sso -. "0..1" .-> dpt_web_app_funkwhale
    svc_sso -. "0..1" .-> dpt_web_app_fusiondirectory
    svc_sso -. "0..1" .-> dpt_web_app_gitea
    svc_sso -. "0..1" .-> dpt_web_app_gitlab
    svc_sso -. "0..1" .-> dpt_web_app_hermes
    svc_sso -. "0..1" .-> dpt_web_app_homeassistant
    svc_sso -. "0..1" .-> dpt_web_app_hugo
    svc_sso -. "0..1" .-> dpt_web_app_jellyfin
    svc_sso -. "0..1" .-> dpt_web_app_jenkins
    svc_sso -. "0..1" .-> dpt_web_app_jira
    svc_sso -. "0..1" .-> dpt_web_app_jitsi
    svc_sso -. "0..1" .-> dpt_web_app_joomla
    svc_sso -. "0..1" .-> dpt_web_app_keycloak
    svc_sso -. "0..1" .-> dpt_web_app_kix
    svc_sso -. "0..1" .-> dpt_web_app_lam
    svc_sso -. "0..1" .-> dpt_web_app_listmonk
    svc_sso -. "0..1" .-> dpt_web_app_litellm
    svc_sso -. "0..1" .-> dpt_web_app_littlejs
    svc_sso -. "0..1" .-> dpt_web_app_magento
    svc_sso -. "0..1" .-> dpt_web_app_mailu
    svc_sso -. "0..1" .-> dpt_web_app_mastodon
    svc_sso -. "0..1" .-> dpt_web_app_matomo
    svc_sso -. "0..1" .-> dpt_web_app_matrix
    svc_sso -. "0..1" .-> dpt_web_app_mattermost
    svc_sso -. "0..1" .-> dpt_web_app_mediawiki
    svc_sso -. "0..1" .-> dpt_web_app_meta
    svc_sso -. "0..1" .-> dpt_web_app_mini_qr
    svc_sso -. "0..1" .-> dpt_web_app_minio
    svc_sso -. "0..1" .-> dpt_web_app_mobilizon
    svc_sso -. "0..1" .-> dpt_web_app_moodle
    svc_sso -. "0..1" .-> dpt_web_app_n8n
    svc_sso -. "0..1" .-> dpt_web_app_navigator
    svc_sso -. "0..1" .-> dpt_web_app_nextcloud
    svc_sso -. "0..1" .-> dpt_web_app_odoo
    svc_sso -. "0..1" .-> dpt_web_app_openbao
    svc_sso -. "0..1" .-> dpt_web_app_openclaw
    svc_sso -. "0..1" .-> dpt_web_app_opencloud
    svc_sso -. "0..1" .-> dpt_web_app_openproject
    svc_sso -. "0..1" .-> dpt_web_app_opentalk
    svc_sso -. "0..1" .-> dpt_web_app_openwebui
    svc_sso -. "0..1" .-> dpt_web_app_peertube
    svc_sso -. "0..1" .-> dpt_web_app_penpot
    svc_sso -. "0..1" .-> dpt_web_app_pgadmin
    svc_sso -. "0..1" .-> dpt_web_app_phpldapadmin
    svc_sso -. "0..1" .-> dpt_web_app_phpmyadmin
    svc_sso -. "0..1" .-> dpt_web_app_pihole
    svc_sso -. "0..1" .-> dpt_web_app_pixelfed
    svc_sso -. "0..1" .-> dpt_web_app_postmarks
    svc_sso -. "0..1" .-> dpt_web_app_pretix
    svc_sso -. "0..1" .-> dpt_web_app_roulette_wheel
    svc_sso -. "0..1" .-> dpt_web_app_seaweedfs
    svc_sso -. "0..1" .-> dpt_web_app_semaphore
    svc_sso -. "0..1" .-> dpt_web_app_shopware
    svc_sso -. "0..1" .-> dpt_web_app_snipe_it
    svc_sso -. "0..1" .-> dpt_web_app_socialhome
    svc_sso -. "0..1" .-> dpt_web_app_stalwart
    svc_sso -. "0..1" .-> dpt_web_app_suitecrm
    svc_sso -. "0..1" .-> dpt_web_app_taiga
    svc_sso -. "0..1" .-> dpt_web_app_wazuh
    svc_sso -. "0..1" .-> dpt_web_app_weblate
    svc_sso -. "0..1" .-> dpt_web_app_wordpress
    svc_sso -. "0..1" .-> dpt_web_app_xwiki
    svc_sso -. "0..1" .-> dpt_web_app_yourls
    svc_sso -. "0..1" .-> dpt_web_app_zammad
    svc_sso -. "0..1" .-> dpt_web_svc_api
    svc_sso -. "0..1" .-> dpt_web_svc_asset
    svc_sso -. "0..1" .-> dpt_web_svc_cdn
    svc_sso -. "0..1" .-> dpt_web_svc_collabora
    svc_sso -. "0..1" .-> dpt_web_svc_coturn
    svc_sso -. "0..1" .-> dpt_web_svc_design
    svc_sso -. "0..1" .-> dpt_web_svc_file
    svc_sso -. "0..1" .-> dpt_web_svc_html
    svc_sso -. "0..1" .-> dpt_web_svc_legal
    svc_sso -. "0..1" .-> dpt_web_svc_libretranslate
    svc_sso -. "0..1" .-> dpt_web_svc_logout
    svc_sso -. "0..1" .-> dpt_web_svc_mirror
    svc_sso -. "0..1" .-> dpt_web_svc_onlyoffice
    svc_sso -. "0..1" .-> dpt_web_svc_s1
    svc_sso -. "0..1" .-> dpt_web_svc_seaweedfs
    svc_sso -. "0..1" .-> dpt_web_svc_simpleicons
    svc_sso -. "0..1" .-> dpt_web_svc_translate
    svc_sso -. "0..1" .-> dpt_web_svc_xmpp

Symbol

Meaning

1:1 solid

fixed relationship

0..1 dashed

conditional, enabled only in matching deployments

0..0 red

declared but turned off in this role

πŸ’»

deploys to the host

🐳

deploys under compose

🐝

deploys under swarm

❌

service explicitly turned off

βš™οΈ

Ansible role dependency from meta/main.yml

Every dependency and dependent is listed; the graph is not truncated.