azure-devops

name	azure-devops
description	Expert knowledge for Azure DevOps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing agent pools, work item processes, Analytics/OData, pipelines, or Azure DevOps Server deployments, and other Azure DevOps related development tasks. Not for Azure Boards (use azure-boards), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Azure DevOps Skill

This skill provides expert guidance for Azure DevOps. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L53	Diagnosing and fixing Azure DevOps issues: Managed DevOps Pools, MCP servers, performance, notifications/email, connectivity/IP allowlists, permissions, wikis, Analytics/Power BI, and upgrades.
Best Practices	L54-L69	Guidance on optimizing Azure DevOps performance, analytics, and reporting: pools, permissions, OData/Power BI queries, flow metrics, caches, and on-prem data cleanup.
Decision Making	L70-L87	Guidance for architectural and migration decisions in Azure DevOps: agent pools, costs, org geography, auth, team structure, wikis, work tracking, analytics/reporting, and Server deployment/upgrade.
Architecture & Design Patterns	L88-L99	Architectural guidance for Azure DevOps/Server: pool architecture, reliability/DR, SQL/database dependencies, and design patterns for simple to complex multi-server topologies and analytics modeling.
Limits & Quotas	L100-L115	Limits, quotas, and constraints in Azure DevOps: org/project naming, images, deletes/retention/recovery, work item/wiki/portfolio limits, dashboards, pipelines size limits, and Analytics data availability
Security	L116-L172	Configuring authentication, authorization, identities, permissions, roles, groups, and auditing for secure access to Azure DevOps organizations, projects, repos, pipelines, analytics, and servers.
Configuration	L173-L251	Configuring Azure DevOps/Server: managed pools (VMs, networking, scaling), notifications, work item/process customization, Analytics/OData, dashboards, backups, services, SQL, and server admin settings.
Integrations & Coding Patterns	L252-L296	Integrating Azure DevOps with tools (VS, SIEM, notifications, clients) and building Analytics/OData- and Power BI–based reports for work items, pipelines, and test/requirements metrics.
Deployment	L297-L328	Installing, configuring, scaling, moving, backing up, restoring, and upgrading Azure DevOps Server/TFS deployments, including SQL, SharePoint, domains, and project collections

Troubleshooting

Topic	URL
Use diagnostic logs for Managed DevOps Pools troubleshooting	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/diagnostics?view=azure-devops
Diagnose and fix Azure Managed DevOps Pools issues	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/troubleshooting?view=azure-devops
Diagnose and fix remote Azure DevOps MCP Server issues	https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server-troubleshooting?view=azure-devops
Investigate Azure DevOps usage and performance issues	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/usage-monitoring?view=azure-devops
Troubleshoot and configure Azure DevOps notifications	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/faq-notifications?view=azure-devops
Troubleshoot Azure DevOps notification email issues	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/troubleshoot-not-getting-email?view=azure-devops
Use subscription logging to debug Azure DevOps notifications	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/use-subscription-logging?view=azure-devops
Allowlist IPs and URLs for Azure DevOps connectivity	https://learn.microsoft.com/en-us/azure/devops/organizations/security/allow-list-ip-url?view=azure-devops
Troubleshoot Azure DevOps access and permission issues	https://learn.microsoft.com/en-us/azure/devops/organizations/security/troubleshoot-permissions?view=azure-devops

Best Practices

Topic	URL
Optimize Managed DevOps Pools cost and performance	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/manage-costs?view=azure-devops
Optimize Azure DevOps permissions for large organizations	https://learn.microsoft.com/en-us/azure/devops/organizations/security/permission-performance-recommendations?view=azure-devops
Apply best practices when querying Azure DevOps Analytics	https://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-best-practices?view=azure-devops
Choose and use Azure DevOps burndown and burnup charts	https://learn.microsoft.com/en-us/azure/devops/report/dashboards/burndown-guidance?view=azure-devops
Use CFDs, cycle time, and lead time to improve flow	https://learn.microsoft.com/en-us/azure/devops/report/dashboards/cumulative-flow-cycle-lead-time-guidance?view=azure-devops
Design efficient OData batch requests for Analytics	https://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/odata-batch?view=azure-devops
Optimize OData Analytics queries for performance limits	https://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/odata-query-guidelines?view=azure-devops
Add last refresh timestamp to Azure DevOps Power BI reports	https://learn.microsoft.com/en-us/azure/devops/report/powerbi/add-last-refresh-time?view=azure-devops
Apply team-based filtering in Azure DevOps Power BI reports	https://learn.microsoft.com/en-us/azure/devops/report/powerbi/create-team-filter?view=azure-devops

Decision Making

Topic	URL
Choose between Managed DevOps Pools and VM scale-set agents	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/migrate-from-scale-set-agents?view=azure-devops
Estimate and compare Managed DevOps Pools costs	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/pricing?view=azure-devops
Choose and manage Azure DevOps organization geography	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-location?view=azure-devops
Migrate Azure DevOps public projects to GitHub	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/migrate-public-project?view=azure-devops
Plan for Azure DevOps public projects retirement	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/public-projects-retirement?view=azure-devops
Choose secure authentication methods for Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/organizations/security/authentication-guidance?view=azure-devops
Decide team structure and Agile tools in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/organizations/settings/about-teams-and-settings?view=azure-devops
Choose between provisioned and code-published Azure DevOps wikis	https://learn.microsoft.com/en-us/azure/devops/project/wiki/provisioned-vs-published-wiki?view=azure-devops
Choose customization approaches for Azure DevOps work tracking	https://learn.microsoft.com/en-us/azure/devops/reference/customize-work?view=azure-devops

Architecture & Design Patterns

Topic	URL
Understand architecture of Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/architecture-overview?view=azure-devops
Understand reliability and disaster recovery for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/reliability-managed-devops-pools?view=azure-devops
Model historical and trend data in Azure DevOps Analytics	https://learn.microsoft.com/en-us/azure/devops/report/powerbi/analytics-historical-filtering?view=azure-devops
Understand Azure DevOps Server resource dependencies	https://learn.microsoft.com/en-us/azure/devops/server/admin/app-dependencies?view=azure-devops-server
Plan complex multi-server Azure DevOps topologies	https://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-complex-topo?view=azure-devops-server
Design moderate Azure DevOps Server topologies	https://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-moderate-topo?view=azure-devops-server
Apply simple Azure DevOps Server topology patterns	https://learn.microsoft.com/en-us/azure/devops/server/architecture/examples-simple-topo?view=azure-devops-server
Understand Azure DevOps Server SQL database architecture	https://learn.microsoft.com/en-us/azure/devops/server/architecture/sql-server-databases?view=azure-devops-server

Limits & Quotas

Topic	URL
Understand quotas and SKUs for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/faq?view=azure-devops
Change Azure DevOps organization image within size limits	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-image?view=azure-devops
Delete Azure DevOps organization and data retention	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/delete-your-organization?view=azure-devops
Recover deleted Azure DevOps organizations within retention limits	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/recover-your-organization?view=azure-devops
Rename Azure DevOps projects and notification behavior	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/rename-project?view=azure-devops
Azure DevOps naming rules and restrictions	https://learn.microsoft.com/en-us/azure/devops/organizations/settings/naming-restrictions?view=azure-devops
Review Azure DevOps work tracking object limits	https://learn.microsoft.com/en-us/azure/devops/organizations/settings/work/object-limits?view=azure-devops
Configure and understand Azure DevOps wiki page follow notifications	https://learn.microsoft.com/en-us/azure/devops/project/wiki/follow-notifications-wiki-pages?view=azure-devops
Add additional portfolio backlogs in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/reference/add-portfolio-backlogs?view=azure-devops

Security

Topic	URL
Configure managed identities for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-identity?view=azure-devops
Configure security for Azure Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-security?view=azure-devops
Configure Azure DevOps organization access security policies	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-application-access-policies?view=azure-devops
Manage Azure DevOps organization ownership and permissions	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-ownership?view=azure-devops
Configure Azure DevOps access via Microsoft Entra ID	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-azure-access?view=azure-devops
Set up Visual Studio authentication with Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-set-up-vs?view=azure-devops
Manage Azure DevOps users and permissions securely	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-user-and-permissions-management?view=azure-devops
Enable and use Azure DevOps audit logging securely	https://learn.microsoft.com/en-us/azure/devops/organizations/audit/azure-devops-auditing?view=azure-devops
Manage security, permissions, and access in Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/organizations/security/?view=azure-devops

Configuration

Topic	URL
Configure advanced settings for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-advanced-settings?view=azure-devops
Configure VM images for Managed DevOps Pools agents	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-images?view=azure-devops
Configure networking for Azure Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-networking?view=azure-devops
Configure settings for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-pool-settings?view=azure-devops
Configure scaling settings for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-scaling?view=azure-devops
Configure data disk storage for Managed DevOps Pool agents	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-storage?view=azure-devops
Configure pipeline demands for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/demands?view=azure-devops
Configure prerequisites for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/prerequisites?view=azure-devops
Configure remote Azure DevOps MCP Server endpoint	https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops
Configure organization and user time zones in Azure DevOps

Integrations & Coding Patterns

Topic	URL
Stream Azure DevOps audit logs to external SIEM	https://learn.microsoft.com/en-us/azure/devops/organizations/audit/auditing-streaming?view=azure-devops
Integrate Azure DevOps notifications with third-party services	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/integrate-third-party-services?view=azure-devops
Connect various clients to Azure DevOps projects	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/connect-to-projects?view=azure-devops
Automate Azure DevOps wiki management using CLI commands	https://learn.microsoft.com/en-us/azure/devops/project/wiki/manage-wikis?view=azure-devops
Clone and edit Azure DevOps wiki Git repos offline	https://learn.microsoft.com/en-us/azure/devops/project/wiki/wiki-update-offline?view=azure-devops
Construct Azure DevOps Analytics OData query URLs	https://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-query-parts?view=azure-devops
Write project and organization-scoped OData queries	https://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/account-scoped-queries?view=azure-devops
Aggregate Azure DevOps work data with OData	https://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/aggregated-data-analytics?view=azure-devops
Use sample Analytics OData queries for Azure DevOps work tracking	https://learn.microsoft.com/en-us/azure/devops/report/extend-analytics/analytics-recipes?view=azure-devops

Deployment

Topic	URL
Migrate deprecated extension-based wikis to Azure DevOps project wikis	https://learn.microsoft.com/en-us/azure/devops/project/wiki/migrate-extension-wiki-pages?view=azure-devops
Schedule and perform Azure DevOps Server database backups	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/back-up-restore?view=azure-devops-server
Restore Azure DevOps application-tier server from failure	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/restore-application-tier-server?view=azure-devops-server
Restore Azure DevOps data to a different server	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/restore-data-different-instance?view=azure-devops-server
Restore Azure DevOps data to same SQL instance	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/restore-data-same-location?view=azure-devops-server
Restore TFS single-server deployment to new hardware	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/tut-single-svr-home?view=azure-devops-server
Install and configure TFS and SharePoint after restore	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/tut-single-svr-install-config-tfs?view=azure-devops-server
Prepare new hardware for restoring TFS single server	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/tut-single-svr-prep-new-hw?view=azure-devops-server
Reconnect services and users after Azure DevOps restore	https://learn.microsoft.com/en-us/azure/devops/server/admin/backup/tut-single-svr-reconn-svcs-users?view=azure-devops-server