container-superposition 0.1.1

package/overlays/grafana/dashboards/observability-overview.json

@@ -0,0 +1,263 @@
+{
+    "annotations": {
+        "list": []
+    },
+    "editable": true,
+    "fiscalYearStartMonth": 0,
+    "graphTooltip": 0,
+    "id": null,
+    "links": [],
+    "liveNow": false,
+    "panels": [
+        {
+            "datasource": {
+                "type": "prometheus",
+                "uid": "prometheus"
+            },
+            "fieldConfig": {
+                "defaults": {
+                    "color": {
+                        "mode": "palette-classic"
+                    },
+                    "custom": {
+                        "axisCenteredZero": false,
+                        "axisColorMode": "text",
+                        "axisLabel": "",
+                        "axisPlacement": "auto",
+                        "barAlignment": 0,
+                        "drawStyle": "line",
+                        "fillOpacity": 10,
+                        "gradientMode": "none",
+                        "hideFrom": {
+                            "tooltip": false,
+                            "viz": false,
+                            "legend": false
+                        },
+                        "lineInterpolation": "linear",
+                        "lineWidth": 1,
+                        "pointSize": 5,
+                        "scaleDistribution": {
+                            "type": "linear"
+                        },
+                        "showPoints": "never",
+                        "spanNulls": false,
+                        "stacking": {
+                            "group": "A",
+                            "mode": "none"
+                        },
+                        "thresholdsStyle": {
+                            "mode": "off"
+                        }
+                    },
+                    "mappings": [],
+                    "thresholds": {
+                        "mode": "absolute",
+                        "steps": [
+                            {
+                                "color": "green",
+                                "value": null
+                            }
+                        ]
+                    },
+                    "unit": "reqps"
+                },
+                "overrides": []
+            },
+            "gridPos": {
+                "h": 8,
+                "w": 12,
+                "x": 0,
+                "y": 0
+            },
+            "id": 1,
+            "options": {
+                "legend": {
+                    "calcs": [],
+                    "displayMode": "list",
+                    "placement": "bottom",
+                    "showLegend": true
+                },
+                "tooltip": {
+                    "mode": "multi",
+                    "sort": "none"
+                }
+            },
+            "pluginVersion": "10.0.0",
+            "targets": [
+                {
+                    "datasource": {
+                        "type": "prometheus",
+                        "uid": "prometheus"
+                    },
+                    "expr": "rate(http_requests_total[5m])",
+                    "refId": "A",
+                    "legendFormat": "{{service}} - {{status}}"
+                }
+            ],
+            "title": "HTTP Request Rate",
+            "type": "timeseries"
+        },
+        {
+            "datasource": {
+                "type": "prometheus",
+                "uid": "prometheus"
+            },
+            "fieldConfig": {
+                "defaults": {
+                    "color": {
+                        "mode": "palette-classic"
+                    },
+                    "custom": {
+                        "axisCenteredZero": false,
+                        "axisColorMode": "text",
+                        "axisLabel": "",
+                        "axisPlacement": "auto",
+                        "barAlignment": 0,
+                        "drawStyle": "line",
+                        "fillOpacity": 10,
+                        "gradientMode": "none",
+                        "hideFrom": {
+                            "tooltip": false,
+                            "viz": false,
+                            "legend": false
+                        },
+                        "lineInterpolation": "linear",
+                        "lineWidth": 1,
+                        "pointSize": 5,
+                        "scaleDistribution": {
+                            "type": "linear"
+                        },
+                        "showPoints": "never",
+                        "spanNulls": false,
+                        "stacking": {
+                            "group": "A",
+                            "mode": "none"
+                        },
+                        "thresholdsStyle": {
+                            "mode": "off"
+                        }
+                    },
+                    "mappings": [],
+                    "thresholds": {
+                        "mode": "absolute",
+                        "steps": [
+                            {
+                                "color": "green",
+                                "value": null
+                            },
+                            {
+                                "color": "red",
+                                "value": 1
+                            }
+                        ]
+                    },
+                    "unit": "s"
+                },
+                "overrides": []
+            },
+            "gridPos": {
+                "h": 8,
+                "w": 12,
+                "x": 12,
+                "y": 0
+            },
+            "id": 2,
+            "options": {
+                "legend": {
+                    "calcs": ["mean", "max"],
+                    "displayMode": "table",
+                    "placement": "bottom",
+                    "showLegend": true
+                },
+                "tooltip": {
+                    "mode": "multi",
+                    "sort": "none"
+                }
+            },
+            "pluginVersion": "10.0.0",
+            "targets": [
+                {
+                    "datasource": {
+                        "type": "prometheus",
+                        "uid": "prometheus"
+                    },
+                    "expr": "histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m]))",
+                    "refId": "A",
+                    "legendFormat": "p99 - {{service}}"
+                },
+                {
+                    "datasource": {
+                        "type": "prometheus",
+                        "uid": "prometheus"
+                    },
+                    "expr": "histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m]))",
+                    "refId": "B",
+                    "legendFormat": "p95 - {{service}}"
+                },
+                {
+                    "datasource": {
+                        "type": "prometheus",
+                        "uid": "prometheus"
+                    },
+                    "expr": "histogram_quantile(0.50, rate(http_request_duration_seconds_bucket[5m]))",
+                    "refId": "C",
+                    "legendFormat": "p50 - {{service}}"
+                }
+            ],
+            "title": "HTTP Request Duration (Percentiles)",
+            "type": "timeseries"
+        },
+        {
+            "datasource": {
+                "type": "loki",
+                "uid": "loki"
+            },
+            "gridPos": {
+                "h": 8,
+                "w": 24,
+                "x": 0,
+                "y": 8
+            },
+            "id": 3,
+            "options": {
+                "dedupStrategy": "none",
+                "enableLogDetails": true,
+                "prettifyLogMessage": false,
+                "showCommonLabels": false,
+                "showLabels": false,
+                "showTime": true,
+                "sortOrder": "Descending",
+                "wrapLogMessage": false
+            },
+            "targets": [
+                {
+                    "datasource": {
+                        "type": "loki",
+                        "uid": "loki"
+                    },
+                    "expr": "{job=\"docker\"} | json",
+                    "refId": "A"
+                }
+            ],
+            "title": "Application Logs",
+            "type": "logs"
+        }
+    ],
+    "refresh": "10s",
+    "schemaVersion": 38,
+    "style": "dark",
+    "tags": ["observability", "overview"],
+    "templating": {
+        "list": []
+    },
+    "time": {
+        "from": "now-1h",
+        "to": "now"
+    },
+    "timepicker": {},
+    "timezone": "",
+    "title": "Observability Overview",
+    "uid": "observability-overview",
+    "version": 1,
+    "weekStart": ""
+}

package/overlays/grafana/devcontainer.patch.json

@@ -0,0 +1,12 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "runServices": ["grafana"],
+    "_serviceOrder": 3,
+    "forwardPorts": [3000],
+    "portsAttributes": {
+        "3000": {
+            "label": "Grafana",
+            "onAutoForward": "openBrowser"
+        }
+    }
+}

package/overlays/grafana/docker-compose.yml

@@ -0,0 +1,27 @@
+version: '3.8'
+services:
+    grafana:
+        image: grafana/grafana:${GRAFANA_VERSION:-latest}
+        environment:
+            - GF_SECURITY_ADMIN_USER=${GRAFANA_ADMIN_USER:-admin}
+            - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
+            - GF_USERS_ALLOW_SIGN_UP=false
+        volumes:
+            - ./grafana-datasources-grafana.yml:/etc/grafana/provisioning/datasources/datasources.yml
+            - ./dashboard-provider-grafana.yml:/etc/grafana/provisioning/dashboards/dashboards.yml
+            - ./dashboards:/etc/grafana/provisioning/dashboards
+            - grafana_data:/var/lib/grafana
+        ports:
+            - '${GRAFANA_PORT:-3000}:3000'
+        depends_on:
+            - prometheus
+            - loki
+            - jaeger
+        networks:
+            - devnet
+
+volumes:
+    grafana_data:
+
+networks:
+    devnet:

package/overlays/grafana/grafana-datasources.yml

@@ -0,0 +1,57 @@
+apiVersion: 1
+
+datasources:
+    - name: Prometheus
+      type: prometheus
+      access: proxy
+      url: http://prometheus:9090
+      isDefault: true
+      editable: true
+      uid: prometheus
+      jsonData:
+          timeInterval: '15s'
+
+    - name: Loki
+      type: loki
+      access: proxy
+      url: http://loki:3100
+      editable: true
+      uid: loki
+      jsonData:
+          derivedFields:
+              - datasourceUid: tempo
+                matcherRegex: "\"trace\\.id\"\\s*:\\s*\"([0-9a-fA-F]+)\""
+                name: TraceID
+                url: '$${__value.raw}'
+              - datasourceUid: jaeger
+                matcherRegex: "\"trace\\.id\"\\s*:\\s*\"([0-9a-fA-F]+)\""
+                name: TraceID (Jaeger)
+                url: '$${__value.raw}'
+
+    - name: Jaeger
+      type: jaeger
+      access: proxy
+      url: http://jaeger:16686
+      editable: true
+      uid: jaeger
+
+    - name: Tempo
+      type: tempo
+      access: proxy
+      url: http://tempo:3200
+      editable: true
+      uid: tempo
+      jsonData:
+          tracesToLogs:
+              datasourceUid: loki
+              tags: ['service']
+              mappedTags: [{ key: 'service.name', value: 'service' }]
+              filterByTraceID: true
+              filterBySpanID: false
+          tracesToMetrics:
+              datasourceUid: prometheus
+              tags: [{ key: 'service.name', value: 'service' }]
+          serviceMap:
+              datasourceUid: prometheus
+          nodeGraph:
+              enabled: true

package/overlays/grafana/overlay.yml

@@ -0,0 +1,21 @@
+id: grafana
+name: Grafana
+description: Observability visualization dashboard with auto-provisioning
+category: observability
+supports:
+    - compose
+requires:
+    - prometheus
+suggests:
+    - loki
+    - jaeger
+    - tempo
+    - promtail
+conflicts: []
+tags:
+    - observability
+    - ui
+    - visualization
+ports:
+    - 3000
+order: 3

package/overlays/grafana/verify.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Verification script for Grafana overlay
+# Confirms Grafana service is accessible
+
+set -e
+
+echo "🔍 Verifying Grafana overlay..."
+echo ""
+
+# Check if Grafana service is running
+echo "1️⃣ Checking Grafana service..."
+# Wait up to 15 seconds for grafana to be ready
+GRAFANA_READY=false
+for i in {1..15}; do
+    if curl -sf http://grafana:3000/api/health &> /dev/null; then
+        echo "   ✅ Grafana service is ready"
+        curl -s http://grafana:3000/api/health | head -n 1
+        GRAFANA_READY=true
+        break
+    fi
+    sleep 1
+done
+
+if [ "$GRAFANA_READY" = false ]; then
+    echo "   ❌ Grafana service not ready after 15 seconds"
+    exit 1
+fi
+
+echo ""
+echo "2️⃣ Checking Grafana version..."
+echo "   Grafana is accessible at http://grafana:3000"
+
+echo ""
+echo "✅ Grafana overlay verification complete"

package/overlays/jaeger/.env.example

@@ -0,0 +1,7 @@
+# Jaeger version
+JAEGER_VERSION=latest
+
+# Jaeger ports
+JAEGER_UI_PORT=16686
+JAEGER_OTLP_GRPC_PORT=4317
+JAEGER_OTLP_HTTP_PORT=4318