[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A8TCQDM6V3G7TBYDWJRN74":3,"skill-same:01M7A8TCQDM6V3G7TBYDWJRN74":142},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M7A8TCQDM6V3G7TBYDWJRN74","grafana-data-source-deployer",null,"Provisions Amazon Managed Grafana workspaces with production defaults: workspace creation, SAML\u002FSSO authentication, data source configuration (CloudWatch, Prometheus\u002FAMP, Athena, Timestream, OpenSearch, X-Ray), IAM role for data source access (workspace role with per-service read permissions), workspace API key, dashboard provisioning (import\u002Fexport JSON), user\u002Fgroup management, workspace endpoint, plugin management, organization units, notification channels, version control integration, and Grafana Enterprise features. Emits a READY_TO_DEPLOY checklist with verification commands. Use when creating a Grafana workspace, configuring data sources, setting up SAML SSO, provisioning dashboards, or managing workspace permissions. Triggers: create grafana workspace, grafana data source cloudwatch, grafana prometheus data source, grafana athena data source, grafana saml sso, grafana workspace api key, grafana dashboard provisioning, grafana iam role.","jhkchan\u002Faws-agent-skills","jhkchan","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1083902?v=4","01M7A2SVQYP9GQTPTDXP5JKYQ4","Jacky Chan","01M7A2SVS117YWCTZABB75HZR1",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: grafana-data-source-deployer\ndescription: 'Provisions Amazon Managed Grafana workspaces with production defaults: workspace creation, SAML\u002FSSO authentication, data source configuration (CloudWatch, Prometheus\u002FAMP, Athena, Timestream, OpenSearch, X-Ray), IAM role for data source access (workspace role with per-service read permissions), workspace API key, dashboard provisioning (import\u002Fexport JSON), user\u002Fgroup management, workspace endpoint, plugin management, organization units, notification channels, version control integration, and Grafana Enterprise features. Emits a READY_TO_DEPLOY checklist with verification commands. Use when creating a Grafana workspace, configuring data sources, setting up SAML SSO, provisioning dashboards, or managing workspace permissions. Triggers: create grafana workspace, grafana data source cloudwatch, grafana prometheus data source, grafana athena data source, grafana saml sso, grafana workspace api key, grafana dashboard provisioning, grafana iam role.'\nlicense: Apache-2.0\ncompatibility: 'Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). For live deployment: AWS CLI v2 with grafana and iam access. Works with Terraform aws_grafana_workspace \u002F aws_grafana_workspace_api_key \u002F aws_grafana_role_association resources and CloudFormation AWS::Grafana::Workspace templates.'\nmetadata:\n  domain: aws-cloudops\n  complexity: high\n  requires_llm: 'true'\n  phase: '1'\n  supports_pipeline: 'true'\n  entry_point: 'false'\n  family: Management\n  task_type: deploy\n  skill_class: capability\n  lifecycle_status: active\n  verdict_shape: READY_TO_DEPLOY | PREREQUISITES_MISSING\n  version: 0.1.0\n  author: Jacky Chan — AWS Community Builder\n  tags: aws, grafana, managed-grafana, cloudops, deploy, management, provisioning, observability, dashboards, data-source, saml-sso\n  dependencies: aws-orchestrator\n  keywords: aws, grafana, managed grafana, data source, cloudops, deploy, provisioning, workspace, saml, sso, cloudwatch, prometheus, dashboard, visualization\n  when_to_use: Invoke when the user wants to create an Amazon Managed Grafana workspace, configure data sources (CloudWatch, Prometheus\u002FAMP, Athena, Timestream, OpenSearch, X-Ray), set up SAML SSO authentication, provision dashboards, create workspace API keys, manage workspace users\u002Fgroups, or configure notification channels. Do NOT invoke for self-hosted Grafana (EC2\u002FECS), Amazon CloudWatch dashboards (use cloudwatch-dashboard skills), or QuickSight.\n---\n\n# Grafana Data Source Deployer\n\nAn AWS CloudOps agent skill that provisions Amazon Managed Grafana\nworkspaces with correct defaults. The skill walks the operator\nthrough workspace creation, authentication (SAML SSO or IAM Identity\nCenter), data source configuration with per-service IAM permissions,\nworkspace API key creation, dashboard provisioning, and notification\nchannels. It captures integration decisions, explains why each default\nmatters, and emits a READY_TO_DEPLOY checklist with copy-pasteable\nverification commands.\n\n## Activation keywords\n\ncreate Grafana workspace, Grafana data source CloudWatch, Grafana\nPrometheus data source, Grafana Athena data source, Grafana SAML SSO,\nGrafana workspace API key, Grafana dashboard provisioning, Grafana\nIAM role.\n\n## STRICT output contract\n\nWhen this skill is invoked with a Grafana workspace provisioning\nrequest (create a workspace, configure a data source, set up SSO,\nprovision dashboards, or a partial configuration), the agent MUST\nrespond with the READY_TO_DEPLOY checklist defined in the \"Output\nformat\" section using the literal all-caps labels `GRAFANA:`,\n`VERDICT:`, `CHECKLIST:`, and `VERIFICATION_COMMANDS:`. Do NOT preface\nthe checklist with prose, headings, or disclaimers — emit the block\nas the first lines of the response. This contract is what assertion-\nbased evals and downstream provisioning pipelines rely on; deviating\nfrom the literal labels breaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n## Quick navigation\n\n| Section | When to read |\n|---|---|\n| Prerequisites | Always — verify before provisioning |\n| Step 1 — Workspace creation | Core workspace model |\n| Step 2 — Authentication (SAML SSO or IAM Identity Center) | Access control |\n| Step 3 — Workspace IAM role and permissions | Per-service data access |\n| Step 4 — Data source configuration | Connecting AWS services |\n| Step 5 — Workspace API key and dashboard provisioning | Programmatic access + dashboards |\n| Step 6 — User management, notifications, plugins | Operations |\n| Step 7 — Version control integration | GitOps |\n| Step 8 — Recent features | Latest |\n| NEVER do these things | Review before signing off |\n| Output format | The literal checklist template |\n| references\u002Fdata-sources-and-iam.md | Data source + IAM detail |\n| references\u002Fauthentication-and-access.md | SSO + user management detail |\n\n## Mindset\n\n**One-line takeaway:** Amazon Managed Grafana is a fully managed\nGrafana server. The workspace IAM role must have per-service read\npermissions for each configured data source (CloudWatch read,\nPrometheus query, Athena query, etc.). SAML SSO requires an external\nIdentity Provider. Data sources are added via the Grafana API or\nconsole after the workspace IAM role has the correct permissions.\n\nThree misconceptions dominate Grafana workspace misdesign at\nprovisioning time:\n\n- **\"Creating the workspace is enough to see data.\"** It is not. The\n  workspace starts with no data sources configured. Each data source\n  must be explicitly added through the Grafana API or console. The\n  workspace IAM role must have the correct per-service read\n  permissions — without them, data source queries fail with permission\n  errors.\n\n- **\"One IAM role fits all data sources.\"** It does not. Each data\n  source requires specific IAM permissions. CloudWatch needs\n  `cloudwatch:ListMetrics` and `cloudwatch:GetMetricData`. Prometheus\n  (AMP) needs `aps:QueryMetrics`. Athena needs\n  `athena:StartQueryExecution` and `athena:GetQueryResults`. A single\n  broad role without the right actions is an anti-pattern — use per-\n  service scoped permissions.\n\n- **\"SAML SSO works out of the box.\"** It does not. SAML SSO requires\n  an external Identity Provider (Okta, Azure AD, etc.). You must\n  configure the IdP metadata, the Grafana SAML assertion attributes,\n  and the ACS URL. Without the IdP setup, SAML authentication cannot\n  function.\n\n## Configuration dependency graph (novel heuristic)\n\nGrafana workspace configurations are NOT independent. The IAM role\nmust be attached before data sources work. SAML SSO requires the\nIdP metadata. Dashboard provisioning requires an API key or SSO\nuser with admin rights. Use this graph to sequence provisioning.\n\n| Configuration | Hard dependencies (API error without) | Silent failure \u002F immutability | Enables downstream |\n|---|---|---|---|\n| Workspace creation | Unique name; authentication type chosen | Workspace is `CREATING` then `ACTIVE`; cannot query until ACTIVE | the workspace endpoint |\n| Workspace IAM role | Trust policy for `grafana.amazonaws.com`; per-service read permissions | Without CloudWatch read, CloudWatch data source queries return empty; without AMP query, Prometheus fails | data source access |\n| Data source: CloudWatch | Workspace ACTIVE; IAM role has `cloudwatch:ListMetrics`, `cloudwatch:GetMetricData` | Missing permissions = silent empty results (no error in UI) | CloudWatch metrics and logs |\n| Data source: Prometheus | Workspace ACTIVE; IAM role has `aps:QueryMetrics`, `aps:ListWorkspaces` | Missing permissions = error in query panel | AMP metrics |\n| Data source: Athena | Workspace ACTIVE; IAM role has `athena:StartQueryExecution`, `athena:GetQueryResults`, S3 read for results | Missing S3 permissions = query execution fails | Athena query results |\n| SAML SSO | External IdP configured; IdP metadata URL\u002FXML; assertion attributes mapped | Without IdP metadata, SAML login fails | SSO user login |\n| Workspace API key | Workspace ACTIVE | API key cannot be retrieved after creation (store immediately) | Programmatic dashboard provisioning |\n| Dashboard provisioning | API key or SSO admin; data sources configured | Unknown data source UID in JSON = panels show \"No data\" | dashboards visible in Grafana |\n| Notification channels | Workspace ACTIVE; external endpoint configured | Misconfigured webhook = alerts silently fail | alerting |\n\n**The IAM-role-per-service row is the one a baseline model misses.**\nCreating the workspace is necessary but not sufficient. Each data\nsource needs specific IAM permissions in the workspace role. Without\nCloudWatch read, the CloudWatch data source connects but returns\nempty results — a silent failure that is extremely hard to debug.\n\n**Cross-dependency gotchas:**\n- The workspace IAM role must be attached at creation time or via\n  `update-workspace`. Changing the role requires a workspace update.\n- Data source UID in imported dashboard JSON must match the workspace\n  data source UID. Mismatched UIDs cause panels to show \"No data\".\n- API keys are shown ONCE at creation. If lost, a new key must be\n  created.\n- SAML SSO and IAM Identity Center are mutually exclusive.\n\n## Expert heuristic: per-service IAM permissions for data sources\n\nA baseline model says \"create a workspace role.\" The correct heuristic\nrecognizes that each data source requires specific IAM permissions.\n\n```text\nWorkspace IAM Role Decision:\n  ├── CloudWatch data source?\n  │     → cloudwatch:ListMetrics, cloudwatch:GetMetricData\n  │       cloudwatch:GetMetricStatistics, cloudwatch:DescribeAlarms\n  │       logs:DescribeLogGroups, logs:StartQuery, logs:GetQueryResults\n  ├── Prometheus (AMP) data source?\n  │     → aps:QueryMetrics, aps:ListWorkspaces, aps:DescribeWorkspace\n  │       aps:GetLabels, aps:GetSeries\n  ├── Athena data source?\n  │     → athena:StartQueryExecution, athena:GetQueryResults\n  │       athena:StopQueryExecution, athena:GetWorkGroup\n  │       s3:GetObject (query results bucket), glue:GetTable, glue:GetDatabase\n  ├── Timestream data source?\n  │     → timestream:DescribeEndpoints, timestream:SelectQuery\n  │       timestream:ListMeasures, timestream:ListDatabases\n  ├── OpenSearch data source?\n  │     → es:ESHttpGet, es:ESHttpPost, es:DescribeDomain\n  └── X-Ray data source?\n        → xray:BatchGetTraces, xray:GetTraceSummaries\n          xray:GetGroups, xray:GetSamplingRules\n```\n\n**Key implication:** missing permissions cause silent empty results.\nThere is no error in the Grafana UI. The data source appears connected,\nbut queries return no data. Always verify per-service permissions.\n\n## Expert heuristic: SAML SSO requires external IdP\n\nIdP-first SAML setup flow (ACS URL, attribute mappings, update-workspace-saml-configuration) moved verbatim to [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md).\nLoad on demand when the authentication mode is SAML.\n\n## Prerequisites (verify before provisioning)\n\nBefore emitting provisioning commands, verify these prerequisites. If\nany are missing, the verdict is **PREREQUISITES_MISSING**.\n\n| Prerequisite | Why it matters | How to verify |\n|---|---|---|\n| Authentication method chosen | SAML SSO or IAM Identity Center | Confirm auth type |\n| IdP metadata available (for SAML) | SAML SSO requires external IdP | Confirm IdP metadata URL\u002FXML |\n| IAM role with per-service permissions | Data source access requires scoped permissions | Verify role policy |\n| AMP workspace ARN (for Prometheus) | Prometheus data source needs the AMP workspace | `aws amp list-workspaces` |\n| Athena workgroup and results bucket (for Athena) | Athena queries need a workgroup and results location | `aws athena list-work-groups` |\n| OpenSearch domain ARN (for OpenSearch) | OpenSearch data source needs the domain | `aws opensearch list-domain-names` |\n| Data source list identified | Each data source needs specific configuration | Confirm data sources |\n\nIf any prerequisite is missing, output `VERDICT: PREREQUISITES_MISSING`\nand cite the specific gap.\n\n## Step 1 — Workspace creation\n\n**Create a Managed Grafana workspace:**\n\n```bash\nWORKSPACE_ID=$(aws grafana create-workspace \\\n  --workspace-name prod-observability \\\n  --account-access-type CURRENT_ACCOUNT \\\n  --authentication-provider AWS_SSO \\\n  --permission-type SERVICE_MANAGED \\\n  --data-sources CLOUDWATCH PROMETHEUS ATHENA \\\n  --description \"Production observability Grafana workspace\" \\\n  --region us-east-1 \\\n  --query 'workspace.id' --output text)\n```\n\n| Parameter | Options | Notes |\n|---|---|---|\n| `--account-access-type` | `CURRENT_ACCOUNT`, `ORGANIZATION` | Use CURRENT_ACCOUNT for standalone |\n| `--authentication-provider` | `AWS_SSO`, `SAML` | AWS_SSO = IAM Identity Center |\n| `--permission-type` | `SERVICE_MANAGED`, `CUSTOM` | SERVICE_MANAGED uses Identity Center groups |\n| `--data-sources` | `CLOUDWATCH`, `PROMETHEUS`, `ATHENA`, `TIMESTREAM`, `OPENSEARCH`, `XRAY` | Pre-register or add later via API |\n\n**Verify workspace is ACTIVE:**\n\n```bash\naws grafana describe-workspace \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --query 'workspace.{Status:status,Endpoint:endpoint}' --region us-east-1\n# Expected: Status: ACTIVE\n```\n\n## Step 2 — Authentication (SAML SSO or IAM Identity Center)\n\n### IAM Identity Center (AWS SSO)\n\n```bash\n# Configured at creation time via --authentication-provider AWS_SSO\n# After workspace creation, assign users\u002Fgroups:\naws grafana update-permissions \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --update-instruction-batch \\\n    \"action=ADD,role=ADMIN,users=[{\\\"id\\\":\\\"user-id\\\",\\\"ssoId\\\":\\\"user@example.com\\\"}]\"\n```\n\n### SAML SSO\n\n```bash\n# Create workspace with SAML\naws grafana create-workspace \\\n  --authentication-provider SAML \\\n  --workspace-role-arn arn:aws:iam::123456789012:role\u002FGrafanaWorkspaceRole ...\n\n# Configure SAML after workspace is ACTIVE\naws grafana update-workspace-saml-configuration \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --saml-configuration '{\n    \"idpMetadata\": {\"url\": \"https:\u002F\u002Fidp.example.com\u002Fsaml\u002Fmetadata\"},\n    \"assertionAttributes\": {\"email\": \"email\", \"name\": \"displayName\", \"login\": \"email\"},\n    \"roleValues\": {\"admin\": \"grafana-admins\", \"editor\": \"grafana-editors\"}\n  }' --region us-east-1\n```\n\n**Critical:** SAML SSO requires an external IdP configured first.\n\n## Step 3 — Workspace IAM role and permissions\n\nThe workspace IAM role grants Grafana access to AWS services for data\nsource queries. Each data source needs specific permissions.\n\n**Create the role and attach permissions:**\n\n```bash\n# Create trust policy for grafana.amazonaws.com\nWORKSPACE_ROLE_ARN=$(aws iam create-role \\\n  --role-name GrafanaWorkspaceRole \\\n  --assume-role-policy-document '{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"grafana.amazonaws.com\"},\"Action\":\"sts:AssumeRole\"}]}' \\\n  --query 'Role.Arn' --output text)\n\n# Attach per-service permissions policy\naws iam put-role-policy \\\n  --role-name GrafanaWorkspaceRole \\\n  --policy-name GrafanaDataSourcePermissions \\\n  --policy-document '{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n      {\"Effect\": \"Allow\", \"Actions\": [\"cloudwatch:ListMetrics\",\"cloudwatch:GetMetricData\",\"cloudwatch:GetMetricStatistics\",\"cloudwatch:DescribeAlarms\",\"logs:DescribeLogGroups\",\"logs:StartQuery\",\"logs:GetQueryResults\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"aps:QueryMetrics\",\"aps:ListWorkspaces\",\"aps:DescribeWorkspace\",\"aps:GetLabels\",\"aps:GetSeries\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"athena:StartQueryExecution\",\"athena:GetQueryResults\",\"athena:StopQueryExecution\",\"athena:GetWorkGroup\",\"glue:GetTable\",\"glue:GetDatabase\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"s3:GetObject\",\"s3:ListBucket\"], \"Resource\": \"arn:aws:s3:::athena-query-results-*\u002F*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"timestream:DescribeEndpoints\",\"timestream:SelectQuery\",\"timestream:ListMeasures\",\"timestream:ListDatabases\"], \"Resource\": \"*\"}\n    ]\n  }'\n\n# Attach role to workspace\naws grafana update-workspace \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --workspace-role-arn \"$WORKSPACE_ROLE_ARN\" --region us-east-1\n```\n\n**Critical:** without the correct permissions, data sources connect but\nreturn empty results. This is a silent failure — no error in the UI.\n\n## Step 4 — Data source configuration\n\nData sources are added via the Grafana HTTP API after the workspace is\nACTIVE and the IAM role has correct permissions.\n\n**Create a workspace API key first:**\n\n```bash\nAPI_KEY=$(aws grafana create-workspace-api-key \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --key-name \"datasource-provisioning\" \\\n  --key-role ADMIN \\\n  --seconds-to-live 3600 --region us-east-1 \\\n  --query 'key' --output text)\n\nENDPOINT=\"https:\u002F\u002Fg-${WORKSPACE_ID}.grafana-workspace.us-east-1.amazonaws.com\"\n```\n\n**Add CloudWatch data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"CloudWatch-prod\",\"type\":\"cloudwatch\",\"access\":\"proxy\",\"jsonData\":{\"authType\":\"ec2_iam_role\",\"defaultRegion\":\"us-east-1\"},\"isDefault\":true}'\n```\n\n**Add Prometheus (AMP) data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Prometheus-AMP\",\"type\":\"prometheus\",\"access\":\"proxy\",\"url\":\"https:\u002F\u002Faps-workspaces.us-east-1.amazonaws.com\u002Fworkspaces\u002Fws-xxx\u002Fapi\u002Fv1\",\"jsonData\":{\"httpMethod\":\"POST\",\"sigV4Auth\":true,\"sigV4AuthType\":\"workspace\",\"sigV4Region\":\"us-east-1\"}}'\n```\n\n**Add Athena data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Athena-prod\",\"type\":\"athena\",\"access\":\"proxy\",\"jsonData\":{\"authType\":\"default\",\"defaultRegion\":\"us-east-1\",\"catalog\":\"AwsDataCatalog\",\"database\":\"default\",\"workgroup\":\"primary\",\"outputLocation\":\"s3:\u002F\u002Fathena-query-results-123456789012\u002F\"}}'\n```\n\n**Key:** use `authType: ec2_iam_role` for CloudWatch and `sigV4Auth: true`\nfor Prometheus. Never hardcode AWS credentials in the data source JSON.\n\n## Step 5 — Workspace API key and dashboard provisioning\n\n**Create a workspace API key:**\n\n```bash\nAPI_KEY=$(aws grafana create-workspace-api-key \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --key-name \"ci-cd-provisioning\" \\\n  --key-role ADMIN \\\n  --seconds-to-live 86400 --region us-east-1 \\\n  --query 'key' --output text)\n```\n\n| Role | Permissions |\n|---|---|\n| `ADMIN` | Full workspace access |\n| `EDITOR` | Create\u002Fedit dashboards, query data sources |\n| `VIEWER` | View dashboards only |\n\n**Critical:** the API key is shown ONCE. Store it in AWS Secrets Manager.\n\n**Import a dashboard from JSON:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdashboards\u002Fdb\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d @dashboard.json\n```\n\n**Critical:** ensure data source UIDs in the dashboard JSON match the\nworkspace data source UIDs. Mismatches cause panels to show \"No data\".\n\n## Step 6 — User management, notifications, plugins\n\nUser\u002Fgroup assignment commands, Slack contact point, and plugin listing moved verbatim to [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md).\nLoad on demand for user, notification, or plugin operations.\n\n## Step 7 — Version control integration\n\nVersion control (GitOps) configuration command moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand for Git-based dashboard provisioning.\n\n## Step 8 — Recent features\n\n2023-2026 feature list (Enterprise RBAC, SNS channel, AMP auto-discovery, Logs Insights, config API, Terraform) moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand when recent features matter.\n\n## NEVER do these things\n\n1. **NEVER assume the workspace is ready immediately after creation.**\n   The workspace goes through `CREATING` to `ACTIVE`. Data source\n   configuration and API calls fail until `ACTIVE`.\n\n2. **NEVER create data sources without correct IAM permissions.** Each\n   data source needs specific per-service permissions. Missing\n   permissions = silent empty results.\n\n3. **NEVER put AWS credentials in data source JSON.** Use\n   `authType: ec2_iam_role` or `sigV4Auth: true` with the workspace\n   IAM role.\n\n4. **NEVER assume SAML SSO works without an external IdP.** SAML\n   requires an external Identity Provider configured first.\n\n5. **NEVER lose the workspace API key.** The key is shown ONCE. Store\n   it in AWS Secrets Manager.\n\n6. **NEVER import dashboard JSON without verifying data source UIDs.**\n   Mismatched UIDs cause panels to show \"No data\" silently.\n\n7. **NEVER mix SAML SSO and IAM Identity Center.** A workspace can use\n   one authentication provider, not both.\n\n8. **NEVER grant overly broad IAM permissions.** Scope the workspace\n   role to specific services and resources.\n\n9. **NEVER forget notification channels for alerts.** Alert rules\n   without contact points silently fire without notifying anyone.\n\n10. **NEVER assume Managed Grafana supports all community plugins.**\n    Verify plugin availability before designing dashboards.\n\n## Output format\n\n```text\nGRAFANA: \u003Cworkspace-id> (\u003Cworkspace-name>, \u003Cauth-provider>)\nVERDICT: READY_TO_DEPLOY | PREREQUISITES_MISSING\nCHECKLIST:\n  [✓|✗] Workspace name: \u003Cname>\n  [✓|✗] Authentication: AWS_SSO (IAM Identity Center) | SAML (IdP: \u003Cprovider>)\n  [✓|✗] SAML IdP metadata: configured (for SAML) | N\u002FA (for AWS_SSO)\n  [✓|✗] Permission type: SERVICE_MANAGED | CUSTOM\n  [✓|✗] Workspace IAM role: \u003Crole-arn> — attached\n  [✓|✗] CloudWatch permissions: cloudwatch:GetMetricData, logs:StartQuery\n  [✓|✗] Prometheus permissions: aps:QueryMetrics (for AMP data source)\n  [✓|✗] Athena permissions: athena:StartQueryExecution, s3:GetObject (for Athena data source)\n  [✓|✗] Data sources: CloudWatch | Prometheus | Athena | Timestream | OpenSearch | X-Ray\n  [✓|✗] Workspace API key: created (role: \u003Crole>)\n  [✓|✗] Dashboard provisioning: \u003Ccount> dashboards imported\n  [✓|✗] Notification channels: \u003Clist>\n  [✓|✗] Workspace endpoint: https:\u002F\u002Fg-\u003Cid>.grafana-workspace.\u003Cregion>.amazonaws.com\n  [✓|✗] Tags: \u003Ckey=value list>\nVERIFICATION_COMMANDS:\n  aws grafana describe-workspace --workspace-id \u003Cworkspace-id> --region \u003Cregion>\n  aws grafana list-permissions --workspace-id \u003Cworkspace-id> --region \u003Cregion>\n  aws iam get-role-policy --role-name \u003Crole-name> --policy-name \u003Cpolicy-name>\n```\n\n### Worked example — CloudWatch + Prometheus workspace with SSO\n\n```text\nGRAFANA: g-aaaa1111 (prod-observability, AWS_SSO)\nVERDICT: READY_TO_DEPLOY\nCHECKLIST:\n  [✓] Workspace name: prod-observability\n  [✓] Authentication: AWS_SSO (IAM Identity Center)\n  [✓] Permission type: SERVICE_MANAGED\n  [✓] Workspace IAM role: arn:aws:iam::123456789012:role\u002FGrafanaWorkspaceRole — attached\n  [✓] CloudWatch permissions: cloudwatch:GetMetricData, cloudwatch:ListMetrics, logs:StartQuery, logs:GetQueryResults\n  [✓] Prometheus permissions: aps:QueryMetrics, aps:ListWorkspaces\n  [✓] Data sources: CloudWatch (default), Prometheus-AMP\n  [✓] Workspace API key: created (role: ADMIN, ttl: 86400s)\n  [✓] Dashboard provisioning: 3 dashboards imported\n  [✓] Notification channels: ops-team-slack\n  [✓] Workspace endpoint: https:\u002F\u002Fg-aaaa1111.grafana-workspace.us-east-1.amazonaws.com\n  [✓] Tags: Environment=production, Team=ops\nVERIFICATION_COMMANDS:\n  aws grafana describe-workspace --workspace-id g-aaaa1111 --region us-east-1\n  aws grafana list-permissions --workspace-id g-aaaa1111 --region us-east-1\n  aws iam get-role-policy --role-name GrafanaWorkspaceRole --policy-name GrafanaDataSourcePermissions\n```\n\n## Error handling\n\nFive failure modes (empty results, SAML login, Prometheus query, UID mismatch, key expiry) moved verbatim to [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\nLoad on demand when diagnosing a failed deployment.\n\n## References (load on demand)\n\n- [references\u002Fdata-sources-and-iam.md](references\u002Fdata-sources-and-iam.md) — per-data-source IAM permissions, data source JSON, and the complete workspace IAM role policy\n- [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md) — SSO\u002FSAML setup, API keys, user\u002Fgroup management, notifications, plugins\n- [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md) — version control (GitOps) integration and 2023-2026 feature notes\n- [references\u002Ferror-handling.md](references\u002Ferror-handling.md) — symptom-to-root-cause for empty results, SAML login, Prometheus, UID mismatch, key expiry\n\n## Domain\n\nAWS CloudOps \u002F Amazon Managed Grafana Workspace Provisioning &\nObservability Visualization.\n\n## AWS documentation\n\n- **Managed Grafana User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002Fwhat-is-amazon-managed-grafana.html\n- **Create a workspace** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-get-started.html\n- **Data sources** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-datasources.html\n- **SAML authentication** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-authentication.html\n- **IAM Identity Center** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-IC-manage-users-groups.html\n- **Workspace role** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-and-IAM.html\n- **API keys** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-admin-permissions.html\n- **Dashboard provisioning** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-dashboard-export-import.html\n- **Grafana API reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FUsing-Grafana-API.html\n- **CloudWatch data source** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-data-source-CloudWatch.html\n","# Grafana Data Source Deployer\n\nAn AWS CloudOps agent skill that provisions Amazon Managed Grafana\nworkspaces with correct defaults. The skill walks the operator\nthrough workspace creation, authentication (SAML SSO or IAM Identity\nCenter), data source configuration with per-service IAM permissions,\nworkspace API key creation, dashboard provisioning, and notification\nchannels. It captures integration decisions, explains why each default\nmatters, and emits a READY_TO_DEPLOY checklist with copy-pasteable\nverification commands.\n\n## Activation keywords\n\ncreate Grafana workspace, Grafana data source CloudWatch, Grafana\nPrometheus data source, Grafana Athena data source, Grafana SAML SSO,\nGrafana workspace API key, Grafana dashboard provisioning, Grafana\nIAM role.\n\n## STRICT output contract\n\nWhen this skill is invoked with a Grafana workspace provisioning\nrequest (create a workspace, configure a data source, set up SSO,\nprovision dashboards, or a partial configuration), the agent MUST\nrespond with the READY_TO_DEPLOY checklist defined in the \"Output\nformat\" section using the literal all-caps labels `GRAFANA:`,\n`VERDICT:`, `CHECKLIST:`, and `VERIFICATION_COMMANDS:`. Do NOT preface\nthe checklist with prose, headings, or disclaimers — emit the block\nas the first lines of the response. This contract is what assertion-\nbased evals and downstream provisioning pipelines rely on; deviating\nfrom the literal labels breaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n## Quick navigation\n\n| Section | When to read |\n|---|---|\n| Prerequisites | Always — verify before provisioning |\n| Step 1 — Workspace creation | Core workspace model |\n| Step 2 — Authentication (SAML SSO or IAM Identity Center) | Access control |\n| Step 3 — Workspace IAM role and permissions | Per-service data access |\n| Step 4 — Data source configuration | Connecting AWS services |\n| Step 5 — Workspace API key and dashboard provisioning | Programmatic access + dashboards |\n| Step 6 — User management, notifications, plugins | Operations |\n| Step 7 — Version control integration | GitOps |\n| Step 8 — Recent features | Latest |\n| NEVER do these things | Review before signing off |\n| Output format | The literal checklist template |\n| references\u002Fdata-sources-and-iam.md | Data source + IAM detail |\n| references\u002Fauthentication-and-access.md | SSO + user management detail |\n\n## Mindset\n\n**One-line takeaway:** Amazon Managed Grafana is a fully managed\nGrafana server. The workspace IAM role must have per-service read\npermissions for each configured data source (CloudWatch read,\nPrometheus query, Athena query, etc.). SAML SSO requires an external\nIdentity Provider. Data sources are added via the Grafana API or\nconsole after the workspace IAM role has the correct permissions.\n\nThree misconceptions dominate Grafana workspace misdesign at\nprovisioning time:\n\n- **\"Creating the workspace is enough to see data.\"** It is not. The\n  workspace starts with no data sources configured. Each data source\n  must be explicitly added through the Grafana API or console. The\n  workspace IAM role must have the correct per-service read\n  permissions — without them, data source queries fail with permission\n  errors.\n\n- **\"One IAM role fits all data sources.\"** It does not. Each data\n  source requires specific IAM permissions. CloudWatch needs\n  `cloudwatch:ListMetrics` and `cloudwatch:GetMetricData`. Prometheus\n  (AMP) needs `aps:QueryMetrics`. Athena needs\n  `athena:StartQueryExecution` and `athena:GetQueryResults`. A single\n  broad role without the right actions is an anti-pattern — use per-\n  service scoped permissions.\n\n- **\"SAML SSO works out of the box.\"** It does not. SAML SSO requires\n  an external Identity Provider (Okta, Azure AD, etc.). You must\n  configure the IdP metadata, the Grafana SAML assertion attributes,\n  and the ACS URL. Without the IdP setup, SAML authentication cannot\n  function.\n\n## Configuration dependency graph (novel heuristic)\n\nGrafana workspace configurations are NOT independent. The IAM role\nmust be attached before data sources work. SAML SSO requires the\nIdP metadata. Dashboard provisioning requires an API key or SSO\nuser with admin rights. Use this graph to sequence provisioning.\n\n| Configuration | Hard dependencies (API error without) | Silent failure \u002F immutability | Enables downstream |\n|---|---|---|---|\n| Workspace creation | Unique name; authentication type chosen | Workspace is `CREATING` then `ACTIVE`; cannot query until ACTIVE | the workspace endpoint |\n| Workspace IAM role | Trust policy for `grafana.amazonaws.com`; per-service read permissions | Without CloudWatch read, CloudWatch data source queries return empty; without AMP query, Prometheus fails | data source access |\n| Data source: CloudWatch | Workspace ACTIVE; IAM role has `cloudwatch:ListMetrics`, `cloudwatch:GetMetricData` | Missing permissions = silent empty results (no error in UI) | CloudWatch metrics and logs |\n| Data source: Prometheus | Workspace ACTIVE; IAM role has `aps:QueryMetrics`, `aps:ListWorkspaces` | Missing permissions = error in query panel | AMP metrics |\n| Data source: Athena | Workspace ACTIVE; IAM role has `athena:StartQueryExecution`, `athena:GetQueryResults`, S3 read for results | Missing S3 permissions = query execution fails | Athena query results |\n| SAML SSO | External IdP configured; IdP metadata URL\u002FXML; assertion attributes mapped | Without IdP metadata, SAML login fails | SSO user login |\n| Workspace API key | Workspace ACTIVE | API key cannot be retrieved after creation (store immediately) | Programmatic dashboard provisioning |\n| Dashboard provisioning | API key or SSO admin; data sources configured | Unknown data source UID in JSON = panels show \"No data\" | dashboards visible in Grafana |\n| Notification channels | Workspace ACTIVE; external endpoint configured | Misconfigured webhook = alerts silently fail | alerting |\n\n**The IAM-role-per-service row is the one a baseline model misses.**\nCreating the workspace is necessary but not sufficient. Each data\nsource needs specific IAM permissions in the workspace role. Without\nCloudWatch read, the CloudWatch data source connects but returns\nempty results — a silent failure that is extremely hard to debug.\n\n**Cross-dependency gotchas:**\n- The workspace IAM role must be attached at creation time or via\n  `update-workspace`. Changing the role requires a workspace update.\n- Data source UID in imported dashboard JSON must match the workspace\n  data source UID. Mismatched UIDs cause panels to show \"No data\".\n- API keys are shown ONCE at creation. If lost, a new key must be\n  created.\n- SAML SSO and IAM Identity Center are mutually exclusive.\n\n## Expert heuristic: per-service IAM permissions for data sources\n\nA baseline model says \"create a workspace role.\" The correct heuristic\nrecognizes that each data source requires specific IAM permissions.\n\n```text\nWorkspace IAM Role Decision:\n  ├── CloudWatch data source?\n  │     → cloudwatch:ListMetrics, cloudwatch:GetMetricData\n  │       cloudwatch:GetMetricStatistics, cloudwatch:DescribeAlarms\n  │       logs:DescribeLogGroups, logs:StartQuery, logs:GetQueryResults\n  ├── Prometheus (AMP) data source?\n  │     → aps:QueryMetrics, aps:ListWorkspaces, aps:DescribeWorkspace\n  │       aps:GetLabels, aps:GetSeries\n  ├── Athena data source?\n  │     → athena:StartQueryExecution, athena:GetQueryResults\n  │       athena:StopQueryExecution, athena:GetWorkGroup\n  │       s3:GetObject (query results bucket), glue:GetTable, glue:GetDatabase\n  ├── Timestream data source?\n  │     → timestream:DescribeEndpoints, timestream:SelectQuery\n  │       timestream:ListMeasures, timestream:ListDatabases\n  ├── OpenSearch data source?\n  │     → es:ESHttpGet, es:ESHttpPost, es:DescribeDomain\n  └── X-Ray data source?\n        → xray:BatchGetTraces, xray:GetTraceSummaries\n          xray:GetGroups, xray:GetSamplingRules\n```\n\n**Key implication:** missing permissions cause silent empty results.\nThere is no error in the Grafana UI. The data source appears connected,\nbut queries return no data. Always verify per-service permissions.\n\n## Expert heuristic: SAML SSO requires external IdP\n\nIdP-first SAML setup flow (ACS URL, attribute mappings, update-workspace-saml-configuration) moved verbatim to [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md).\nLoad on demand when the authentication mode is SAML.\n\n## Prerequisites (verify before provisioning)\n\nBefore emitting provisioning commands, verify these prerequisites. If\nany are missing, the verdict is **PREREQUISITES_MISSING**.\n\n| Prerequisite | Why it matters | How to verify |\n|---|---|---|\n| Authentication method chosen | SAML SSO or IAM Identity Center | Confirm auth type |\n| IdP metadata available (for SAML) | SAML SSO requires external IdP | Confirm IdP metadata URL\u002FXML |\n| IAM role with per-service permissions | Data source access requires scoped permissions | Verify role policy |\n| AMP workspace ARN (for Prometheus) | Prometheus data source needs the AMP workspace | `aws amp list-workspaces` |\n| Athena workgroup and results bucket (for Athena) | Athena queries need a workgroup and results location | `aws athena list-work-groups` |\n| OpenSearch domain ARN (for OpenSearch) | OpenSearch data source needs the domain | `aws opensearch list-domain-names` |\n| Data source list identified | Each data source needs specific configuration | Confirm data sources |\n\nIf any prerequisite is missing, output `VERDICT: PREREQUISITES_MISSING`\nand cite the specific gap.\n\n## Step 1 — Workspace creation\n\n**Create a Managed Grafana workspace:**\n\n```bash\nWORKSPACE_ID=$(aws grafana create-workspace \\\n  --workspace-name prod-observability \\\n  --account-access-type CURRENT_ACCOUNT \\\n  --authentication-provider AWS_SSO \\\n  --permission-type SERVICE_MANAGED \\\n  --data-sources CLOUDWATCH PROMETHEUS ATHENA \\\n  --description \"Production observability Grafana workspace\" \\\n  --region us-east-1 \\\n  --query 'workspace.id' --output text)\n```\n\n| Parameter | Options | Notes |\n|---|---|---|\n| `--account-access-type` | `CURRENT_ACCOUNT`, `ORGANIZATION` | Use CURRENT_ACCOUNT for standalone |\n| `--authentication-provider` | `AWS_SSO`, `SAML` | AWS_SSO = IAM Identity Center |\n| `--permission-type` | `SERVICE_MANAGED`, `CUSTOM` | SERVICE_MANAGED uses Identity Center groups |\n| `--data-sources` | `CLOUDWATCH`, `PROMETHEUS`, `ATHENA`, `TIMESTREAM`, `OPENSEARCH`, `XRAY` | Pre-register or add later via API |\n\n**Verify workspace is ACTIVE:**\n\n```bash\naws grafana describe-workspace \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --query 'workspace.{Status:status,Endpoint:endpoint}' --region us-east-1\n# Expected: Status: ACTIVE\n```\n\n## Step 2 — Authentication (SAML SSO or IAM Identity Center)\n\n### IAM Identity Center (AWS SSO)\n\n```bash\n# Configured at creation time via --authentication-provider AWS_SSO\n# After workspace creation, assign users\u002Fgroups:\naws grafana update-permissions \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --update-instruction-batch \\\n    \"action=ADD,role=ADMIN,users=[{\\\"id\\\":\\\"user-id\\\",\\\"ssoId\\\":\\\"user@example.com\\\"}]\"\n```\n\n### SAML SSO\n\n```bash\n# Create workspace with SAML\naws grafana create-workspace \\\n  --authentication-provider SAML \\\n  --workspace-role-arn arn:aws:iam::123456789012:role\u002FGrafanaWorkspaceRole ...\n\n# Configure SAML after workspace is ACTIVE\naws grafana update-workspace-saml-configuration \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --saml-configuration '{\n    \"idpMetadata\": {\"url\": \"https:\u002F\u002Fidp.example.com\u002Fsaml\u002Fmetadata\"},\n    \"assertionAttributes\": {\"email\": \"email\", \"name\": \"displayName\", \"login\": \"email\"},\n    \"roleValues\": {\"admin\": \"grafana-admins\", \"editor\": \"grafana-editors\"}\n  }' --region us-east-1\n```\n\n**Critical:** SAML SSO requires an external IdP configured first.\n\n## Step 3 — Workspace IAM role and permissions\n\nThe workspace IAM role grants Grafana access to AWS services for data\nsource queries. Each data source needs specific permissions.\n\n**Create the role and attach permissions:**\n\n```bash\n# Create trust policy for grafana.amazonaws.com\nWORKSPACE_ROLE_ARN=$(aws iam create-role \\\n  --role-name GrafanaWorkspaceRole \\\n  --assume-role-policy-document '{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":\"grafana.amazonaws.com\"},\"Action\":\"sts:AssumeRole\"}]}' \\\n  --query 'Role.Arn' --output text)\n\n# Attach per-service permissions policy\naws iam put-role-policy \\\n  --role-name GrafanaWorkspaceRole \\\n  --policy-name GrafanaDataSourcePermissions \\\n  --policy-document '{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n      {\"Effect\": \"Allow\", \"Actions\": [\"cloudwatch:ListMetrics\",\"cloudwatch:GetMetricData\",\"cloudwatch:GetMetricStatistics\",\"cloudwatch:DescribeAlarms\",\"logs:DescribeLogGroups\",\"logs:StartQuery\",\"logs:GetQueryResults\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"aps:QueryMetrics\",\"aps:ListWorkspaces\",\"aps:DescribeWorkspace\",\"aps:GetLabels\",\"aps:GetSeries\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"athena:StartQueryExecution\",\"athena:GetQueryResults\",\"athena:StopQueryExecution\",\"athena:GetWorkGroup\",\"glue:GetTable\",\"glue:GetDatabase\"], \"Resource\": \"*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"s3:GetObject\",\"s3:ListBucket\"], \"Resource\": \"arn:aws:s3:::athena-query-results-*\u002F*\"},\n      {\"Effect\": \"Allow\", \"Actions\": [\"timestream:DescribeEndpoints\",\"timestream:SelectQuery\",\"timestream:ListMeasures\",\"timestream:ListDatabases\"], \"Resource\": \"*\"}\n    ]\n  }'\n\n# Attach role to workspace\naws grafana update-workspace \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --workspace-role-arn \"$WORKSPACE_ROLE_ARN\" --region us-east-1\n```\n\n**Critical:** without the correct permissions, data sources connect but\nreturn empty results. This is a silent failure — no error in the UI.\n\n## Step 4 — Data source configuration\n\nData sources are added via the Grafana HTTP API after the workspace is\nACTIVE and the IAM role has correct permissions.\n\n**Create a workspace API key first:**\n\n```bash\nAPI_KEY=$(aws grafana create-workspace-api-key \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --key-name \"datasource-provisioning\" \\\n  --key-role ADMIN \\\n  --seconds-to-live 3600 --region us-east-1 \\\n  --query 'key' --output text)\n\nENDPOINT=\"https:\u002F\u002Fg-${WORKSPACE_ID}.grafana-workspace.us-east-1.amazonaws.com\"\n```\n\n**Add CloudWatch data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"CloudWatch-prod\",\"type\":\"cloudwatch\",\"access\":\"proxy\",\"jsonData\":{\"authType\":\"ec2_iam_role\",\"defaultRegion\":\"us-east-1\"},\"isDefault\":true}'\n```\n\n**Add Prometheus (AMP) data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Prometheus-AMP\",\"type\":\"prometheus\",\"access\":\"proxy\",\"url\":\"https:\u002F\u002Faps-workspaces.us-east-1.amazonaws.com\u002Fworkspaces\u002Fws-xxx\u002Fapi\u002Fv1\",\"jsonData\":{\"httpMethod\":\"POST\",\"sigV4Auth\":true,\"sigV4AuthType\":\"workspace\",\"sigV4Region\":\"us-east-1\"}}'\n```\n\n**Add Athena data source:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdatasources\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"Athena-prod\",\"type\":\"athena\",\"access\":\"proxy\",\"jsonData\":{\"authType\":\"default\",\"defaultRegion\":\"us-east-1\",\"catalog\":\"AwsDataCatalog\",\"database\":\"default\",\"workgroup\":\"primary\",\"outputLocation\":\"s3:\u002F\u002Fathena-query-results-123456789012\u002F\"}}'\n```\n\n**Key:** use `authType: ec2_iam_role` for CloudWatch and `sigV4Auth: true`\nfor Prometheus. Never hardcode AWS credentials in the data source JSON.\n\n## Step 5 — Workspace API key and dashboard provisioning\n\n**Create a workspace API key:**\n\n```bash\nAPI_KEY=$(aws grafana create-workspace-api-key \\\n  --workspace-id \"$WORKSPACE_ID\" \\\n  --key-name \"ci-cd-provisioning\" \\\n  --key-role ADMIN \\\n  --seconds-to-live 86400 --region us-east-1 \\\n  --query 'key' --output text)\n```\n\n| Role | Permissions |\n|---|---|\n| `ADMIN` | Full workspace access |\n| `EDITOR` | Create\u002Fedit dashboards, query data sources |\n| `VIEWER` | View dashboards only |\n\n**Critical:** the API key is shown ONCE. Store it in AWS Secrets Manager.\n\n**Import a dashboard from JSON:**\n\n```bash\ncurl -s -X POST \"$ENDPOINT\u002Fapi\u002Fdashboards\u002Fdb\" \\\n  -H \"Authorization: Bearer $API_KEY\" -H \"Content-Type: application\u002Fjson\" \\\n  -d @dashboard.json\n```\n\n**Critical:** ensure data source UIDs in the dashboard JSON match the\nworkspace data source UIDs. Mismatches cause panels to show \"No data\".\n\n## Step 6 — User management, notifications, plugins\n\nUser\u002Fgroup assignment commands, Slack contact point, and plugin listing moved verbatim to [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md).\nLoad on demand for user, notification, or plugin operations.\n\n## Step 7 — Version control integration\n\nVersion control (GitOps) configuration command moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand for Git-based dashboard provisioning.\n\n## Step 8 — Recent features\n\n2023-2026 feature list (Enterprise RBAC, SNS channel, AMP auto-discovery, Logs Insights, config API, Terraform) moved verbatim to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\nLoad on demand when recent features matter.\n\n## NEVER do these things\n\n1. **NEVER assume the workspace is ready immediately after creation.**\n   The workspace goes through `CREATING` to `ACTIVE`. Data source\n   configuration and API calls fail until `ACTIVE`.\n\n2. **NEVER create data sources without correct IAM permissions.** Each\n   data source needs specific per-service permissions. Missing\n   permissions = silent empty results.\n\n3. **NEVER put AWS credentials in data source JSON.** Use\n   `authType: ec2_iam_role` or `sigV4Auth: true` with the workspace\n   IAM role.\n\n4. **NEVER assume SAML SSO works without an external IdP.** SAML\n   requires an external Identity Provider configured first.\n\n5. **NEVER lose the workspace API key.** The key is shown ONCE. Store\n   it in AWS Secrets Manager.\n\n6. **NEVER import dashboard JSON without verifying data source UIDs.**\n   Mismatched UIDs cause panels to show \"No data\" silently.\n\n7. **NEVER mix SAML SSO and IAM Identity Center.** A workspace can use\n   one authentication provider, not both.\n\n8. **NEVER grant overly broad IAM permissions.** Scope the workspace\n   role to specific services and resources.\n\n9. **NEVER forget notification channels for alerts.** Alert rules\n   without contact points silently fire without notifying anyone.\n\n10. **NEVER assume Managed Grafana supports all community plugins.**\n    Verify plugin availability before designing dashboards.\n\n## Output format\n\n```text\nGRAFANA: \u003Cworkspace-id> (\u003Cworkspace-name>, \u003Cauth-provider>)\nVERDICT: READY_TO_DEPLOY | PREREQUISITES_MISSING\nCHECKLIST:\n  [✓|✗] Workspace name: \u003Cname>\n  [✓|✗] Authentication: AWS_SSO (IAM Identity Center) | SAML (IdP: \u003Cprovider>)\n  [✓|✗] SAML IdP metadata: configured (for SAML) | N\u002FA (for AWS_SSO)\n  [✓|✗] Permission type: SERVICE_MANAGED | CUSTOM\n  [✓|✗] Workspace IAM role: \u003Crole-arn> — attached\n  [✓|✗] CloudWatch permissions: cloudwatch:GetMetricData, logs:StartQuery\n  [✓|✗] Prometheus permissions: aps:QueryMetrics (for AMP data source)\n  [✓|✗] Athena permissions: athena:StartQueryExecution, s3:GetObject (for Athena data source)\n  [✓|✗] Data sources: CloudWatch | Prometheus | Athena | Timestream | OpenSearch | X-Ray\n  [✓|✗] Workspace API key: created (role: \u003Crole>)\n  [✓|✗] Dashboard provisioning: \u003Ccount> dashboards imported\n  [✓|✗] Notification channels: \u003Clist>\n  [✓|✗] Workspace endpoint: https:\u002F\u002Fg-\u003Cid>.grafana-workspace.\u003Cregion>.amazonaws.com\n  [✓|✗] Tags: \u003Ckey=value list>\nVERIFICATION_COMMANDS:\n  aws grafana describe-workspace --workspace-id \u003Cworkspace-id> --region \u003Cregion>\n  aws grafana list-permissions --workspace-id \u003Cworkspace-id> --region \u003Cregion>\n  aws iam get-role-policy --role-name \u003Crole-name> --policy-name \u003Cpolicy-name>\n```\n\n### Worked example — CloudWatch + Prometheus workspace with SSO\n\n```text\nGRAFANA: g-aaaa1111 (prod-observability, AWS_SSO)\nVERDICT: READY_TO_DEPLOY\nCHECKLIST:\n  [✓] Workspace name: prod-observability\n  [✓] Authentication: AWS_SSO (IAM Identity Center)\n  [✓] Permission type: SERVICE_MANAGED\n  [✓] Workspace IAM role: arn:aws:iam::123456789012:role\u002FGrafanaWorkspaceRole — attached\n  [✓] CloudWatch permissions: cloudwatch:GetMetricData, cloudwatch:ListMetrics, logs:StartQuery, logs:GetQueryResults\n  [✓] Prometheus permissions: aps:QueryMetrics, aps:ListWorkspaces\n  [✓] Data sources: CloudWatch (default), Prometheus-AMP\n  [✓] Workspace API key: created (role: ADMIN, ttl: 86400s)\n  [✓] Dashboard provisioning: 3 dashboards imported\n  [✓] Notification channels: ops-team-slack\n  [✓] Workspace endpoint: https:\u002F\u002Fg-aaaa1111.grafana-workspace.us-east-1.amazonaws.com\n  [✓] Tags: Environment=production, Team=ops\nVERIFICATION_COMMANDS:\n  aws grafana describe-workspace --workspace-id g-aaaa1111 --region us-east-1\n  aws grafana list-permissions --workspace-id g-aaaa1111 --region us-east-1\n  aws iam get-role-policy --role-name GrafanaWorkspaceRole --policy-name GrafanaDataSourcePermissions\n```\n\n## Error handling\n\nFive failure modes (empty results, SAML login, Prometheus query, UID mismatch, key expiry) moved verbatim to [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\nLoad on demand when diagnosing a failed deployment.\n\n## References (load on demand)\n\n- [references\u002Fdata-sources-and-iam.md](references\u002Fdata-sources-and-iam.md) — per-data-source IAM permissions, data source JSON, and the complete workspace IAM role policy\n- [references\u002Fauthentication-and-access.md](references\u002Fauthentication-and-access.md) — SSO\u002FSAML setup, API keys, user\u002Fgroup management, notifications, plugins\n- [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md) — version control (GitOps) integration and 2023-2026 feature notes\n- [references\u002Ferror-handling.md](references\u002Ferror-handling.md) — symptom-to-root-cause for empty results, SAML login, Prometheus, UID mismatch, key expiry\n\n## Domain\n\nAWS CloudOps \u002F Amazon Managed Grafana Workspace Provisioning &\nObservability Visualization.\n\n## AWS documentation\n\n- **Managed Grafana User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002Fwhat-is-amazon-managed-grafana.html\n- **Create a workspace** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-get-started.html\n- **Data sources** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-datasources.html\n- **SAML authentication** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-authentication.html\n- **IAM Identity Center** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-IC-manage-users-groups.html\n- **Workspace role** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-and-IAM.html\n- **API keys** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-admin-permissions.html\n- **Dashboard provisioning** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-dashboard-export-import.html\n- **Grafana API reference** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FUsing-Grafana-API.html\n- **CloudWatch data source** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fgrafana\u002Flatest\u002Fuserguide\u002FAMG-data-source-CloudWatch.html\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":41},{"tags":25,"phase":26,"author":27,"domain":28,"family":29,"version":30,"keywords":31,"task_type":32,"complexity":33,"entry_point":34,"skill_class":35,"when_to_use":36,"dependencies":37,"requires_llm":38,"verdict_shape":39,"lifecycle_status":40,"supports_pipeline":38},"aws, grafana, managed-grafana, cloudops, deploy, management, provisioning, observability, dashboards, data-source, saml-sso","1","Jacky Chan — AWS Community Builder","aws-cloudops","Management","0.1.0","aws, grafana, managed grafana, data source, cloudops, deploy, provisioning, workspace, saml, sso, cloudwatch, prometheus, dashboard, visualization","deploy","high","false","capability","Invoke when the user wants to create an Amazon Managed Grafana workspace, configure data sources (CloudWatch, Prometheus\u002FAMP, Athena, Timestream, OpenSearch, X-Ray), set up SAML SSO authentication, provision dashboards, create workspace API keys, manage workspace users\u002Fgroups, or configure notification channels. Do NOT invoke for self-hosted Grafana (EC2\u002FECS), Amazon CloudWatch dashboards (use cloudwatch-dashboard skills), or QuickSight.","aws-orchestrator","true","READY_TO_DEPLOY | PREREQUISITES_MISSING","active","Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). For live deployment: AWS CLI v2 with grafana and iam access. Works with Terraform aws_grafana_workspace \u002F aws_grafana_workspace_api_key \u002F aws_grafana_role_association resources and CloudFormation AWS::Grafana::Workspace templates.","main","eeace51bd5dd1db2030729d83eeab988861553aa","skills\u002Fgrafana-data-source-deployer",0,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills","https:\u002F\u002Fgithub.com\u002Fjhkchan","CTO & Co-Founder @Beever-AI  & @votee. CAISP. AWS Community Builder. Organizer@GDGCloudHK. MongoDB Champion. Technopreneur + Infornographer.","2026-09-24 08:54:10",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add jhkchan\u002Faws-agent-skills --skill grafana-data-source-deployer",{"tool":56,"command":57},"bunx","bunx skills add jhkchan\u002Faws-agent-skills --skill grafana-data-source-deployer",{"tool":59,"command":60},"pnpm","pnpm dlx skills add jhkchan\u002Faws-agent-skills --skill grafana-data-source-deployer","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002FSKILL.md",true,[64,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"eval\u002Ftest-cases.yaml","REFERENCE","参考文档",6203,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Feval\u002Ftest-cases.yaml",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"evals\u002Fbaselines\u002Fcloudwatch-data-source.md",762,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fbaselines\u002Fcloudwatch-data-source.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"evals\u002Fbaselines\u002Fdashboard-provisioning.md",690,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fbaselines\u002Fdashboard-provisioning.md",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"evals\u002Fbaselines\u002Fmissing-workspace-role-permissions.md",814,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fbaselines\u002Fmissing-workspace-role-permissions.md",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"evals\u002Fbaselines\u002Fmulti-data-source-saml-sso.md",716,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fbaselines\u002Fmulti-data-source-saml-sso.md",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"evals\u002Fbaselines\u002Fprometheus-amp-data-source.md",732,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fbaselines\u002Fprometheus-amp-data-source.md",{"path":91,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":92,"sourceHtmlUrl":93},"evals\u002Feval_config.yaml",1817,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Feval_config.yaml",{"path":95,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":96,"sourceHtmlUrl":97},"evals\u002Fevals.json",9721,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fevals.json",{"path":99,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":100,"sourceHtmlUrl":101},"evals\u002Fprompts\u002Fcloudwatch-data-source.md",583,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fprompts\u002Fcloudwatch-data-source.md",{"path":103,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":104,"sourceHtmlUrl":105},"evals\u002Fprompts\u002Fdashboard-provisioning.md",616,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fprompts\u002Fdashboard-provisioning.md",{"path":107,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":108,"sourceHtmlUrl":109},"evals\u002Fprompts\u002Fmissing-workspace-role-permissions.md",571,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fprompts\u002Fmissing-workspace-role-permissions.md",{"path":111,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":112,"sourceHtmlUrl":113},"evals\u002Fprompts\u002Fmulti-data-source-saml-sso.md",680,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fprompts\u002Fmulti-data-source-saml-sso.md",{"path":115,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":116,"sourceHtmlUrl":117},"evals\u002Fprompts\u002Fprometheus-amp-data-source.md",551,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fevals\u002Fprompts\u002Fprometheus-amp-data-source.md",{"path":119,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":120,"sourceHtmlUrl":121},"examples\u002FREADME.md",7914,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fexamples\u002FREADME.md",{"path":123,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fadvanced-patterns.md",1257,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Freferences\u002Fadvanced-patterns.md",{"path":127,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Fauthentication-and-access.md",14260,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Freferences\u002Fauthentication-and-access.md",{"path":131,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Fdata-sources-and-iam.md",11453,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Freferences\u002Fdata-sources-and-iam.md",{"path":135,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":136,"sourceHtmlUrl":137},"references\u002Ferror-handling.md",949,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Freferences\u002Ferror-handling.md",{"path":139,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":140,"sourceHtmlUrl":141},"skill.usf.yaml",4410,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fgrafana-data-source-deployer\u002Fskill.usf.yaml",[143,150,157,164,171,178],{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":149,"publishedAt":19},"01M7ADVD60X4PCAPKSE58P9NDC","xray-tracing-deployer","Deploys AWS X-Ray distributed tracing with production-grade configuration: X-Ray daemon deployment (EC2 systemd, ECS sidecar, EKS DaemonSet, Lambda built-in), SDK instrumentation (Java, Python, Node.js, Go, .NET) with annotations and metadata, sampling rules (default reservoir + rate vs custom rules with URL \u002F method \u002F service-name predicates), service map generation, trace query and retrieval, groups and insights, CloudWatch ServiceLens integration, IAM permissions (PutTraceSegments, GetSamplingRules), and latest features (Lambda Powertools tracing, OpenTelemetry \u002F ADOT Collector support, W3C trace context). Emits a READY_TO_DEPLOY checklist with every configuration item verified. Use when enabling X-Ray on a new application, adding tracing to ECS \u002F EKS \u002F Lambda, validating a sampling configuration, or generating daemon deployment CLI and IaC templates. Triggers: X-Ray, distributed tracing, X-Ray daemon, sampling rules, service map, X-Ray SDK, OpenTelemetry, ADOT, Lambda Powertools, CloudWatch ServiceLens.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxray-tracing-deployer\u002FSKILL.md",[],[],{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":19},"01M7ADTVJ7DCBM9CB1FY51GH7J","wellarchitected-workload-auditor","Audits AWS Well-Architected Tool workloads for review staleness, per-pillar high-risk issue counts, milestone tracking gaps, and remediation plan completeness. Emits a deterministic verdict (STALE_REVIEW | HIGH_RISK | CONFIG_GAP | OK) per workload with per-pillar risk breakdown, milestone trend analysis, and specific remediation. Use when reviewing Well-Architected workloads, checking WA review freshness, auditing high-risk issues per pillar, validating milestone coverage, or tracking remediation plans.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-workload-auditor\u002FSKILL.md",[],[],{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":19},"01M7ADT59G6FTTNZYHT2QRPNNP","wellarchitected-review-operator","Operates AWS Well-Architected Tool reviews end-to-end — creates workloads, runs pillar reviews (operational excellence, security, reliability, performance, cost optimization, sustainability, Prosperity), answers questions with risk-tier rationale, generates reports and improvement plans, creates milestones, and integrates with Trusted Advisor and Well-Architected Labs. Runs deterministic pre-checks (workload existence, lens availability, pillar coverage), emits the exact update-answer \u002F get-consolidated-report CLI behind a CONFIRM gate, and verifies risk-tier transitions. Emits READY | BLOCKED | COMPLETED. Use when creating a workload, answering pillar questions, generating an improvement plan, creating a milestone, or integrating with Trusted Advisor. Triggers: well-architected tool, well architected review, workload review, pillar, operational excellence, security, reliability, performance, cost optimization, sustainability, prosperity, improvement plan, milestone, trusted advisor.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-review-operator\u002FSKILL.md",[],[],{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M7ADSH5JA9QHNPPHQCD7EVA7","wafv2-web-acl-deployer","Provisions AWS WAFv2 Web ACLs with correct production defaults: scope selection (CLOUDFRONT vs REGIONAL), managed rule groups (AWSManagedRulesCommonRuleSet, SQLiRuleSet, LinuxRuleSet, WindowsRuleSet, IPReputationList, BotControlRuleSet, AmazonIpReputationList, ATP), custom rules (byte match, IP set, regex pattern, geo match, size constraint, rate-based), rule priority ordering, logging destinations (Kinesis Firehose, CloudWatch Logs, S3), resource association (ALB, API Gateway, CloudFront), rate-based rules with aggregate keys (IP, forwarded IP), Challenge and CAPTCHA actions, and account takeover prevention. Emits a READY_TO_DEPLOY checklist. Use when creating a Web ACL, attaching managed rules, configuring rate limiting, enabling WAF logging, associating a Web ACL with an ALB\u002FAPI Gateway\u002FCloudFront, or configuring CAPTCHA\u002FChallenge actions. Triggers: create WAF Web ACL, WAFv2, managed rule groups, WAF rate limiting, WAF logging, WAF CAPTCHA, WAF Challenge action, bot control, ATP managed rules.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-deployer\u002FSKILL.md",[],[],{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":19},"01M7ADRYFAT8R73FBNCHRC573X","wafv2-web-acl-auditor","Audits AWS WAFv2 Web ACL configurations to determine whether the ACL provides effective protection: default-action posture (Allow vs Block), managed-rule-group coverage gaps, rule effectiveness (BLOCK vs COUNT, shadow\u002Fbypass rules, stale exclusions), rate-based rule correctness, logging and visibility configuration, and text-transformation bypass vectors. Emits a deterministic verdict per Web ACL. Use when reviewing a WAFv2 Web ACL for security posture, checking managed-rule coverage, validating rate-limit configuration, auditing WAF logging, or hardening a WAF before production deployment. Triggers: WAF, WAFv2, Web ACL, managed rule group, AWSManagedRules, rate-based rule, CAPTCHA, Challenge, OverrideAction, Count mode, forwarded IP, Bot Control, ATP, text transformation, WAF logging, WAF visibility, OWASP, SQLi, XSS, RFI.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-auditor\u002FSKILL.md",[],[],{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":19},"01M7ADR8W7G72JX4KFGN03QK8Q","waf-rule-deployer","Provisions AWS WAFv2 rule sets with production defaults: Web ACL creation (CloudFront scope in us-east-1 vs Regional scope), rule groups (managed vs custom) with capacity planning in WCU (Web ACL Capacity Units, 1500 default per ACL), managed rule groups (AWSManagedRulesCommonRuleSet, AWSManagedRulesSQLiRuleSet, AWSManagedRulesAmazonIpReputationList, AWSManagedRulesLinuxRuleSet, AWSManagedRulesWindowsRuleSet, AWSManagedRulesUnixRuleSet), custom rules (byte-match, regex pattern set, geo-match, rate-based), IP set and regex pattern set resources, rule priority ordering (lowest number evaluated first), action types (allow, block, count, CAPTCHA, Challenge), bot control managed rule group, account takeover. Triggers: create WAF rule, WAF managed rule group, WAF custom rule, WAF byte match, WAF geo match, WAF rate based rule, WAF IP set, WAF regex pattern set, WAF WCU budget, WAF CloudFront ACL, WAF logging Kinesis Firehose, WAF bot control, WAF ATP, WAF label matching, WAF Challenge action, WAF CAPTCHA.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwaf-rule-deployer\u002FSKILL.md",[],[]]