Using service map

Overview

This tutorial walks you through using Service map in Business Applications to build a visual architecture diagram of your Azure resources. You will create a Service map, place and connect resources on the canvas, group related resources into sub-orchestrations, and set the diagram as the default view. By the end of this tutorial, you will have an accurate, exportable architecture diagram linked to live monitoring state.

Business value

A Service map gives your operations and development teams a shared, up-to-date picture of how your application's Azure resources are connected. This reduces onboarding time for new team members, accelerates root-cause analysis during incidents by showing data and control flows at a glance, and provides a downloadable architecture record for compliance, audits, and handoffs.

Prerequisites

Before you begin, make sure you have:

• A Business Application with at least two resources already associated
• The Manage permission for Service map to create, edit, and set defaults (the Read permission allows viewing only)

Required permissions

Permissions are assigned per role under Settings > User management > Roles.

How it works

Each Business Application includes a Service map section accessible from the application's navigation. Opening this section displays a canvas for the default Service map and a resource pane on the left listing all resources associated with the Business Application. You populate the canvas by clicking resources in the pane, then connect them by drawing edges between resource icons to represent data flows or control dependencies.

Service maps are independent of the underlying resources; they persist their layout even when resources change. When a new resource is added to the Business Application, its icon is automatically added to all existing Service maps for that application, ready to be positioned and connected. Monitoring state is visible on saved maps but hidden while you are in Edit mode.

Steps

This tutorial takes you from an empty canvas to a saved, default-designated Service map with grouped resources. Navigate to your Business Application and select Service map from the application navigation to get started.

Step 1: Create a Service map

Creating a Service map opens a named canvas where you will model a specific orchestration or flow within the Business Application.

1. Click Add Service map in the Service map section.
2. Enter a name that describes the flow or sub-system you are mapping (for example, Order Intake Flow or Notification Pipeline).
3. In the resource pane on the left, click each resource you want to include on the canvas. Each click places the resource icon on the diagram.
4. Draw connections between resources by clicking and dragging from the edge of one resource icon to another, following the actual data or control flow.
5. Reposition icons by clicking and dragging them from their centre until the layout is clear and readable.
6. Click Save to commit the diagram. Resource icons display their current monitoring state after saving.

Step 2: Group related resources

Grouping lets you cluster resource icons into named sub-orchestrations, making complex flows easier to navigate and understand at a glance.

1. On the canvas, select the resource icons you want to group (hold Shift and click each icon, or draw a selection box around them).
2. Use the Grouping option to group the selected icons. Enter a name for the group (for example, Message Intake or Backend Processing).
3. Click Save to persist the grouping.

To remove a grouping later, select the group on the canvas and use the Ungroup option.

Step 3: Set the Service map as the default

Setting a default Service map determines which diagram is shown first when anyone opens the Service map section of this Business Application. Set the most important or most frequently referenced map as the default.

1. Click the Actions dropdown on the Service map you want to set as default.
2. Select Set as default.

The selected Service map now loads first whenever anyone navigates to the Service map section of this Business Application.

Step 4: Download the Service map

Downloading saves the current diagram as an SVG file for offline storage, compliance records, or sharing with stakeholders who do not have Turbo360 access.

1. Click the Actions dropdown on the Service map you want to download.
2. Select Download. The file is saved in SVG format.

(Optional) Edit the Service map later

As your architecture evolves, update the Service map to reflect resource additions, removals, and flow changes.

1. Click the Actions dropdown on the Service map you want to modify.
2. Select Edit.
3. Make changes to the resource layout, connections, or name.
4. Click Update to save your changes.

Troubleshooting

1. A resource does not appear in the resource pane on the canvas
   Cause: The resource has not been associated with the Business Application.
   Fix: Navigate to the Business Application settings, associate the resource, then return to the Service map. The resource icon will appear in the resource pane.

2. Monitoring state icons are blank or not updating on the canvas
   Cause: The Service map was not saved after the most recent monitoring cycle, or you are currently in Edit mode.
   Fix: Exit Edit mode and save the diagram. Allow one monitoring cycle to complete for the state to refresh.

3. The Actions dropdown options (Edit, Delete, Download, Set as default) are not visible
   Cause: Your role has only the Read permission for Service map. The Manage permission is required for all edit and management actions.
   Fix: Contact your Turbo360 administrator to have the Manage permission added to your role.

4. A newly added resource icon does not appear on existing Service maps
   Cause: The Service map page was open or cached before the resource was associated with the Business Application.
   Fix: Refresh the Service map page. Icons for newly associated resources are added automatically to all existing Service maps for that application.

5. The downloaded SVG file is blank or missing resources
   Cause: The Service map was not saved before downloading, or the canvas was empty at the time of export.
   Fix: Ensure all resources and connections are placed and saved on the canvas, then download again.

Related articles

• What is service map?
• Configuring a service map
• Managing Business Applications
• Setting up your first business application
• Managing resources