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 Boards/work items, pipelines, repos, Analytics/OData/Power BI, 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-04-19","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-L54	Diagnosing and fixing Azure DevOps issues: Managed DevOps Pools, performance, email notifications, connectivity/allowlists, permissions, dashboards/Analytics, wikis restore, and upgrade failures.
Best Practices	L55-L69	Guidance on optimizing Azure DevOps performance, analytics, and reporting: cost-efficient pools, fast OData queries, Power BI reports, dashboards, and data cleanup/maintenance.
Decision Making	L70-L85	Guidance on Azure DevOps architectural choices: org/project/team structure, work tracking and wikis, analytics/reporting, cost and topology of agents and Azure DevOps Server deployments.
Architecture & Design Patterns	L86-L97	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	L98-L112	Limits, quotas, and behaviors for Azure DevOps orgs, projects, naming, access levels, work tracking, dashboards, wikis, pipelines, and Analytics data availability/latency.
Security	L113-L173	Managing Azure DevOps security: identities, auth, permissions, access levels, groups, auditing, project/repo/pipeline rights, server service accounts, SSL, and download integrity.
Configuration	L174-L252	Configuring Azure DevOps/Server: Managed DevOps Pools, notifications, Boards/work items, Analytics/OData/Power BI, dashboards, search, backups, networking, email/SMTP, and server admin settings.
Integrations & Coding Patterns	L253-L298	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	L299-L330	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
Troubleshoot common Managed DevOps Pools issues	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/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
Investigate delayed Azure DevOps notification emails	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/troubleshoot-delayed-email?view=azure-devops
Troubleshoot missing Azure DevOps notification emails	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/troubleshoot-not-getting-email?view=azure-devops
Troubleshoot unexpected Azure DevOps notification emails	https://learn.microsoft.com/en-us/azure/devops/organizations/notifications/troubleshoot-unexpected-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
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
Add time-in-state DAX measures for Azure DevOps work items	https://learn.microsoft.com/en-us/azure/devops/report/powerbi/create-timeinstate-report?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
Plan Azure DevOps project structure and scaling	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/about-projects?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
Choose tools to query Azure DevOps Analytics data	https://learn.microsoft.com/en-us/azure/devops/report/analytics/analytics-query-tools?view=azure-devops
Plan Azure DevOps reporting migration to Analytics	https://learn.microsoft.com/en-us/azure/devops/report/powerbi/reporting-roadmap?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
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
Azure DevOps work tracking and process 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
Azure Pipelines ARM integration size limit changes	https://learn.microsoft.com/en-us/azure/devops/release-notes/2023/sprint-225-update

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 settings for Managed DevOps Pools	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-security?view=azure-devops
Configure privacy policy URL for Azure DevOps public projects	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/add-privacy-policy-url?view=azure-devops
Configure Azure DevOps application access and security policies	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-application-access-policies?view=azure-devops
Change Azure DevOps organization ownership and permissions	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/change-organization-ownership?view=azure-devops
Manage Azure DevOps access via Microsoft Entra ID	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-azure-access?view=azure-devops
Manage Azure DevOps users, permissions, and tokens 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
Configure Azure DevOps project public visibility and access	https://learn.microsoft.com/en-us/azure/devops/organizations/projects/make-project-public?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 pipelines	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-images?view=azure-devops
Configure networking for Managed DevOps Pools agents	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-networking?view=azure-devops
Configure basic 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 additional storage for Managed DevOps Pools agents	https://learn.microsoft.com/en-us/azure/devops/managed-devops-pools/configure-storage?view=azure-devops
Configure demands and capabilities in 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 access	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
Set up Visual Studio integration with Azure DevOps	https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/faq-set-up-vs?view=azure-devops
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

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