az network traffic-manager profile show --resource-group <resource-group> --name <profile> --output jsonTraffic Manager
Azure Traffic Manager is a DNS-based traffic-routing service that directs clients to healthy application endpoints according to a configured routing method. It monitors endpoints and returns DNS answers, but it is not a proxy, so client traffic flows directly to the selected endpoint.
Source: Microsoft Learn - Azure Traffic Manager overview Reviewed 2026-05-28
- Exam trap
- Expecting Traffic Manager to proxy traffic, terminate TLS, apply WAF rules, or inspect HTTP requests.
- Production check
- Show the profile and confirm routing method, TTL, and monitor path match the architecture decision.
Article details and learning context
- Aliases
- Azure Traffic Manager, DNS traffic routing, traffic manager profile, global DNS routing, DNS failover
- Difficulty
- intermediate
- CLI mappings
- 5
- Last verified
- 2026-05-28
- Review level
- field-manual-complete
- Article depth
- field-manual-complete
Understand the concept
In plain English
Traffic Manager helps users reach the right public application endpoint by answering DNS queries intelligently. It can send users to a primary region, the closest performing region, a weighted rollout target, a geography-specific endpoint, or another profile. It does not sit in the request path like a reverse proxy. After DNS resolution, the client connects directly to the chosen endpoint. That makes Traffic Manager useful for global failover and routing, but it also means endpoint health, DNS TTL, and client caching matter. That distinction prevents design mistakes during failover planning. That distinction prevents design mistakes during failover planning.
Why it matters
Traffic Manager matters because customers do not care which region failed; they care whether the public name still reaches a working endpoint. It provides a simple control point for DNS-level distribution, failover, and regional steering without changing application code. The hard part is not creating a profile. The hard part is choosing the right routing method, probe path, TTL, endpoint readiness model, and rollback procedure. For global systems, those choices decide whether a regional incident becomes a brief reroute or a confusing customer outage. Clear evidence keeps design reviews practical, accountable, and tied to business risk instead of guesswork. Clear evidence keeps design reviews practical, accountable, and tied to business risk instead of guesswork.
Technical context
In Azure architecture, Traffic Manager sits in the global DNS routing layer. A profile owns a trafficmanager.net name, routing method, DNS TTL, endpoint-monitoring settings, and endpoints that can be Azure, external, or nested. It works above regional services such as App Service, Static Web Apps, public load balancers, API gateways, or non-Azure endpoints. It interacts with DNS zones, custom domains, health probes, endpoint priority, weighted rollout, geographic routing, Azure Monitor, failover runbooks, and application-level resilience. It is not a virtual network device or TLS termination point. Probe design is central.
Exam context
Compare with
Where it is used
Where you see it
- In the Azure portal, a Traffic Manager profile shows routing method, DNS name, TTL, monitor settings, endpoint list, and current probe status for operational triage.
- In Azure CLI output, profile and endpoint commands expose priority, weight, target, endpoint status, monitor path, DNS configuration, and rollout review settings during incident review.
- In DNS troubleshooting, CNAME records, resolver caches, TTL values, dig output, and profile names explain why clients reach one regional endpoint during validation and troubleshooting.
Common situations
- Provide DNS-level failover between primary and secondary public application endpoints without putting Traffic Manager in the request path.
- Gradually shift a small percentage of users to a new region or external endpoint using weighted routing.
- Route users to geography-specific endpoints for data residency, localization, or regional operating requirements.
- Nest profiles to combine routing methods, such as geographic routing first and priority failover inside each geography.
- Direct users away from an endpoint during planned maintenance after confirming health probes and DNS TTL behavior.
Illustrative Azure scenarios
These examples show how the concept can affect design and operations. They are illustrative scenarios, not customer claims.
Scenario 01 Crisis hotline keeps regional sites reachable Scenario, objectives, solution, measured impact, and takeaway.
A nonprofit crisis hotline served public web chat from two Azure regions, but past regional outages forced volunteers to publish temporary links manually.
- Fail users over to the secondary region without changing the public help URL.
- Keep DNS behavior understandable for a small operations team.
- Ensure health checks reflected chat-service readiness, not just web-server uptime.
- Reduce manual communications during high-stress incidents.
The team deployed a Traffic Manager profile using priority routing and placed both regional chat endpoints behind the same custom domain through DNS CNAME records. Engineers changed the probe path to a readiness endpoint that checked the chat API, queue dependency, and database connectivity. The secondary region ran warm with enough capacity for expected emergency traffic. CLI commands exported profile and endpoint settings into the runbook, including the exact command to disable or re-enable an endpoint. Monthly drills simulated primary-region database failure and verified DNS answers, monitor status, and volunteer dashboard behavior.
- Failover drill time dropped from 37 minutes of manual coordination to under 6 minutes.
- The readiness probe caught two dependency failures that a simple home-page probe would have missed.
- Volunteer-facing incident instructions shrank from three pages to one command-backed checklist.
- The public help URL stayed unchanged through two planned regional maintenance events.
Traffic Manager is valuable when DNS-level failover is enough and the real work is proving endpoint readiness before people need help.
Scenario 02 Industrial IoT vendor routes devices during regional maintenance Scenario, objectives, solution, measured impact, and takeaway.
An industrial IoT vendor collected telemetry from factories in several countries and needed to move device traffic during planned maintenance without changing device firmware.
- Route devices to a healthy regional ingestion endpoint through DNS.
- Respect geography-specific operating requirements for European and North American factories.
- Drain one endpoint for maintenance without causing ingestion gaps.
- Give support teams simple evidence that DNS routing changed as planned.
Architects used nested Traffic Manager profiles. The outer profile used geographic routing to keep factories in approved regions, while inner profiles used priority routing for regional primary and backup ingestion endpoints. Device DNS TTL was set low enough for maintenance windows but high enough to avoid unnecessary resolver churn. Health probes checked an ingestion readiness endpoint that validated queue availability and certificate configuration. Operators used CLI to list endpoint states, disable the maintenance endpoint, and export profile JSON before every change. Monitoring compared incoming telemetry volume by region with endpoint monitor status after DNS shifted.
- Planned maintenance completed with zero firmware changes and no customer-side DNS edits.
- Telemetry ingestion gaps fell from 14 minutes in the previous process to under 90 seconds.
- Geographic routing kept 99.9% of sampled European device resolutions inside the approved routing group.
- Support escalation volume during maintenance windows fell 62% after runbooks included CLI evidence and DNS checks.
Traffic Manager can solve global endpoint-selection problems cleanly when DNS behavior, health probes, and regional constraints are designed together.
Scenario 03 Media platform controls launch traffic with weighted routing Scenario, objectives, solution, measured impact, and takeaway.
A streaming media platform launched a redesigned account portal and needed to send a small percentage of users to the new regional stack before full cutover.
- Shift traffic gradually without requiring application redeploys.
- Rollback quickly if sign-in or subscription management errors increased.
- Compare real user latency between old and new stacks.
- Keep the routing change visible to release managers and support.
The release team configured a Traffic Manager profile with weighted endpoints for the existing account portal and the new regional stack. Health probes targeted a readiness endpoint that checked identity, subscription API, and cache connectivity. Before each increase, operators used CLI to show endpoint weights and export profile JSON. The rollout moved from 5% to 25% to 50% after error rate, latency, and support contacts stayed within thresholds. When one cache dependency degraded, the team reduced the new endpoint weight instead of redeploying code. DNS checks from multiple networks confirmed that traffic distribution changed after TTL windows elapsed.
- The portal launch reached 50% traffic with no full outage and no emergency DNS edits.
- A cache-related error spike was contained to 5% of users during the first rollout hour.
- P95 account-page latency improved 27% after the team tuned the new endpoint before full cutover.
- Release managers used exported endpoint weights as the source of truth during support briefings.
Weighted Traffic Manager routing gives release teams a simple DNS-level control for gradual exposure and fast rollback when proxy-layer features are not required.
Azure CLI
Azure CLI is useful because Traffic Manager changes are often made during incidents, maintenance windows, or release gates where repeatability matters. After ten years in Azure engineering, I want exact commands to show profiles, endpoints, routing methods, weights, priorities, monitor status, and DNS names before anyone clicks around under pressure. CLI makes drills scriptable, exports evidence for change review, and reduces mistakes when disabling or restoring an endpoint. It also helps compare production with staging so routing behavior is tested before customers rely on it. Store repeatable evidence so reviews are not portal-dependent during audits or incidents. Store repeatable evidence so reviews are not portal-dependent during audits or incidents.
Useful for
- Show the profile before a change to confirm routing method, DNS TTL, monitor path, and current status.
- List endpoints to review priority, weight, target, and monitor state during failover or maintenance.
- Disable an endpoint in a controlled maintenance window after confirming the rollback command.
- Check whether a relative trafficmanager.net DNS name is available before creating a profile.
- Export metrics and endpoint health evidence for post-incident review and routing-method tuning.
Before you run a command
- Confirm the tenant, subscription, resource group, profile name, endpoint type, and custom-domain DNS ownership.
- Understand whether the command is read-only or will immediately alter DNS answers for users.
- Check current endpoint capacity and health before enabling, disabling, or changing weights.
- Know the DNS TTL and expected propagation behavior; not every client will switch instantly.
- Capture current profile and endpoint JSON before mutating changes so rollback is precise.
What the output tells you
- Profile output shows routing method, relative DNS name, TTL, monitor protocol, path, port, and profile status.
- Endpoint output shows target resource, endpoint status, monitor status, priority, weight, and geography or subnet settings.
- DNS check output tells whether the requested trafficmanager.net name can be used for a new profile.
- Metric output helps confirm query volume, endpoint health changes, and whether routing behavior changed during an incident.
- Resource ID and tags identify ownership, environment, and the governance scope for approvals or locks.
Mapped commands
Traffic Manager CLI commands
directaz network traffic-manager endpoint list --resource-group <resource-group> --profile-name <profile> --type azureEndpoints --output tableaz network traffic-manager endpoint update --resource-group <resource-group> --profile-name <profile> --name <endpoint> --type azureEndpoints --endpoint-status Disabledaz network traffic-manager profile check-dns --name <relative-dns-name> --output jsonaz monitor metrics list --resource <traffic-manager-profile-id> --interval PT5M --output tableArchitecture context
Architecturally, Traffic Manager belongs in the global entry design for public applications that need endpoint selection across regions or providers. I choose it when DNS-level routing is sufficient and I do not need edge TLS termination, WAF inspection, caching, or URL-based proxy routing. It can sit in front of regional stacks that already use Application Gateway, Front Door, API Management, or load balancers, but the responsibility must be clear. Health probes should test a meaningful readiness path, not just a generic home page. DNS TTL, routing method, endpoint priority, and failover drills are core design choices, not afterthoughts. This distinction prevents teams from choosing it for the wrong problem. Testing should include real DNS clients. Keep scope clear. Testing should include real DNS clients. Endpoint readiness matters more than profile creation. I also document when Front Door is the better fit.
- Security
- Security impact is indirect because Traffic Manager routes DNS answers; it does not terminate TLS, inspect HTTP requests, or enforce WAF rules. Risk still appears through endpoint exposure, DNS ownership, management permissions, and emergency changes. Only trusted operators should edit profiles, endpoints, probe settings, or custom-domain records. Endpoints should still use TLS, identity controls, private backends where appropriate, and protection from direct unwanted access. Activity logs and change approvals should capture routing updates because a mistaken endpoint can send users to the wrong service. Keep ownership, audit trails, approval paths, and emergency access documented before production changes. Keep ownership, audit trails, approval paths, and emergency access documented before production changes.
- Cost
- Cost impact is direct for Traffic Manager profile usage and DNS queries, and indirect for the endpoints it can keep warm across regions. The service is usually not the largest bill item, but the architecture behind it can be expensive if every endpoint requires standby compute, databases, cache, and monitoring. Cost reviews should compare routing goals with secondary-region capacity commitments, test traffic, idle resources, and alternative services such as Front Door. The right design balances standby expense against measurable outage risk and recovery expectations. Review ownership, idle usage, scale assumptions, chargeback signals, and retention behavior before expanding capacity. Review ownership, idle usage, scale assumptions, chargeback signals, and retention behavior before expanding capacity.
- Reliability
- Reliability is the main reason to use Traffic Manager. It can route clients away from unhealthy endpoints, distribute traffic across regions, or support planned maintenance without changing the public name. Reliability still depends on probe quality, DNS TTL, client resolver behavior, secondary-region readiness, and data replication. A probe that checks only a home page may miss database or queue failures. Operators should test manual disable and restore steps, validate behavior from multiple networks, and keep user communication aligned with DNS propagation delay. Test normal operation, degraded behavior, rollback steps, and dependency failure before production changes. Test normal operation, degraded behavior, rollback steps, and dependency failure before production changes.
- Performance
- Performance depends on routing method, DNS resolver location, TTL, endpoint health, and the actual application path after DNS resolution. Performance routing can send users toward endpoints with better network latency, but Traffic Manager does not accelerate content or proxy requests. If clients or resolvers cache DNS answers, they may continue using an endpoint until TTL expires. Weighted routing can protect performance during gradual releases by limiting traffic to a new region. Operators should measure real user latency, endpoint response time, probe status, and traffic distribution together. Use Front Door or CDN when edge acceleration, caching, or HTTP-layer routing is required. Performance tests should validate the whole path, not only DNS response. Compare synthetic probes with real-user measurements before declaring success.
- Operations
- Operators manage Traffic Manager by reviewing profiles, endpoints, routing method, DNS TTL, probe path, monitor status, and custom-domain records. During changes, they export before-state JSON, verify endpoint health, adjust weight or priority, and confirm DNS resolution from multiple networks. During incidents, they compare Azure monitor status with synthetic tests and application telemetry to decide whether the probe reflects real readiness. Runbooks should include disable, enable, rollback, DNS validation, escalation contacts, and post-incident evidence for each profile. Store repeatable command output, owner contacts, rollback evidence, normal examples, and post-change verification steps with the operational runbook. Store repeatable command output, owner contacts, rollback evidence, normal examples, and post-change verification steps with the operational runbook.
Common mistakes
- Expecting Traffic Manager to proxy traffic, terminate TLS, apply WAF rules, or inspect HTTP requests.
- Using a health probe path that returns success while the real application dependency is broken.
- Setting TTL too high for aggressive failover expectations or too low without considering DNS query behavior.
- Forgetting that secondary endpoints need capacity, data readiness, and security controls before failover.
- Changing endpoint weights or status without capturing the previous configuration for rollback.