Measuring IDP Success and Adoption

# grafana-dashboard-platform-metrics.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: platform-metrics-dashboard
  labels:
    grafana_dashboard: "true"
data:
  platform-metrics.json: |
    {
      "title": "IDP Health & Adoption",
      "panels": [
        {
          "title": "Self-Service vs Ticket Requests (Weekly)",
          "type": "timeseries",
          "targets": [{
            "expr": "sum(rate(platform_self_service_requests_total[7d]))",
            "legendFormat": "Self-service"
          }, {
            "expr": "sum(rate(platform_ticket_requests_total[7d]))",
            "legendFormat": "Manual tickets"
          }]
        },
        {
          "title": "Time to First Deploy (New Services)",
          "type": "stat",
          "targets": [{
            "expr": "histogram_quantile(0.50, platform_service_creation_duration_seconds_bucket)",
            "legendFormat": "p50 creation time"
          }]
        },
        {
          "title": "Golden Path Adoption Rate",
          "type": "gauge",
          "targets": [{
            "expr": "sum(platform_services_on_golden_path) / sum(platform_services_total) * 100",
            "legendFormat": "% on golden path"
          }]
        },
        {
          "title": "Developer Satisfaction (Quarterly Survey)",
          "type": "stat",
          "targets": [{
            "expr": "platform_developer_satisfaction_score",
            "legendFormat": "Satisfaction (1-10)"
          }]
        }
      ]
    }

#!/usr/bin/env python3
"""Weekly IDP adoption report."""
import requests
from datetime import datetime, timedelta

BACKSTAGE_API = "https://backstage.internal/api"

def get_adoption_metrics():
    # Total services in catalog
    entities = requests.get(
        f"{BACKSTAGE_API}/catalog/entities?filter=kind=component"
    ).json()

    total = len(entities)
    on_golden_path = sum(
        1 for e in entities
        if e["metadata"].get("annotations", {})
        .get("platform.io/golden-path-version")
    )
    has_owner = sum(
        1 for e in entities
        if e.get("spec", {}).get("owner") != "unknown"
    )

    # Self-service requests this week
    week_ago = (datetime.now() - timedelta(days=7)).isoformat()
    requests_data = requests.get(
        f"{BACKSTAGE_API}/platform/requests?since={week_ago}"
    ).json()

    self_service = sum(1 for r in requests_data if r["type"] == "self-service")
    tickets = sum(1 for r in requests_data if r["type"] == "ticket")

    print(f"=== IDP Adoption Report ({datetime.now():%Y-%m-%d}) ===")
    print(f"Services in catalog:     {total}")
    print(f"On golden path:          {on_golden_path}/{total} ({on_golden_path/total*100:.0f}%)")
    print(f"With valid owner:        {has_owner}/{total} ({has_owner/total*100:.0f}%)")
    print(f"Self-service this week:  {self_service}")
    print(f"Tickets this week:       {tickets}")
    print(f"Self-service ratio:      {self_service/(self_service+tickets)*100:.0f}%")

    # Example output:
    # === IDP Adoption Report (2026-04-09) ===
    # Services in catalog:     187
    # On golden path:          142/187 (76%)
    # With valid owner:        179/187 (96%)
    # Self-service this week:  34
    # Tickets this week:       6
    # Self-service ratio:      85%

if __name__ == "__main__":
    get_adoption_metrics()