This page explains how to connect your Cisco Cloud Observability account with Microsoft Azure using the Cisco Cloud Observability user interface.

If you prefer to use the Connections API, Call the Cisco Cloud Observability APIs and see Getting Started with Azure

This document contains references to third-party documentation. Cisco AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.

These are the high-level steps:

  1. Register an Application
  2. Connect Your Azure Account to Cisco Cloud Observability
  3. Add Custom Configuration for Azure Connection

  4. Verify Connection and Observe Entities

Performance and Scaling Requirements 

For performance and scaling requirements, see Cloud Performance and Scaling.

1. Register a Client Application in the Azure Portal

  1. Log in to portal.azure.com.
  2. On the home page, click App registrations.

    See Register a client application in Azure Active Directory in the Microsoft documentation for details.

  3. On App registrations, click New Registration.
  4. On Register an application under Name, type the name of the application you want to register. The application is the client that you are creating to grant Cisco Cloud Observability access.
  5. Select Single-tenant, the default setting.
  6. Click Register
  7. On the AppD-monitoring-app page, copy and save the Application (client) ID and the Directory (tenant) ID to add to Cisco Cloud Observability.
    Click Add a certificate or secret (beside Client credentials).
  8. On the Certificates & secrets page, click Client secrets.
  9. Click + New client secret.
  10. On the Add a client secret pop-up, add a description and select an expiration option.

    When the secret expires, Cisco Cloud Observability cannot monitor your resources. You must return to this page and create another secret and update the connection.

  11. Click Add.
  12. On Certificates & secrets, copy the Value and save it to add to Cisco Cloud Observability. Value is the Client Secret Key. This is the only opportunity to copy the Client Secret Key. If you do not capture it, you can create a new secret.
  13. Click  and select Home.
  14. Use the search bar to locate your subscription and copy your subscription ID

Ensure that you save your Azure subscription information (Tenant ID, Subscription ID, Client ID, and Client Secret Key). 

To assign the app to the subscription:

  1. Click on the subscription name that you want to use from subscriptions service.
  2. Navigate to Access control (IAM).
  3. Click + Add.
  4. Select add role assignment.
  5. Select Reader role by searching Reader using search bar. 
  6. Click Next.
  7. Click Select Members and search for the app you registered in Step 6.
  8. Click Select.
  9. (Optional) Add description to explain the role assignment.
  10. Click Next.
  11. Click Review + assign. The application is now assigned to the subscription with assigned role and permissions. See Assign Azure roles using the Azure portal.

Repeat this process for each connection you want to monitor. To monitor multiple subscriptions, create multiple connections. 

You must have owner access on the respective subscription to be able to create a new role assignment. The Reader role must be assigned.

2. Connect Your Azure Account to Cisco Cloud Observability 

The instructions to connect your Azure account are documented on the New Azure Connection UI page of Cisco Cloud Observability. To navigate to this page: 

  1. Log into the Cisco Cloud Observability UI.
  2. Use the left-hand sidebar to navigate to Configure > Cloud Connections.
  3. Click Microsoft Azure Monitoring.
  4. Follow the instructions on the New Azure Connection UI page to connect your Azure account to Cisco Cloud Observability

3. Add Custom Configuration for Azure Connection

The instructions to add a custom configuration for Azure connections are documented on the New Azure Connection UI page of Cisco Cloud Observability. To navigate to this page: 

  1. Log into the Cisco Cloud Observability UI.
  2. Use the left-hand sidebar to navigate to Configure > Cloud Connections.
  3. Click on your new Azure connection.
  4. Follow the instructions on the New Azure Connection UI page to add a custom configuration for Azure connections.

4. Verify Connection and Observe Entities

  1. When the connection state on the Cloud Connections page displays Active, Cisco Cloud Observability automatically begins monitoring the supported Azure services
  2. Use the left-hand sidebar to navigate to the Observe page. You can now monitor your entities using entity-centric pages (ECPs). For a list of the entities and data that can be monitored, see Observe Azure Entities.

Next Steps

Review Connection State

The Cloud Connections page displays a list of cloud connections and their current condition. To navigate to this page, use the Cisco Cloud Observability left-hand sidebar to navigate to Configure > Cloud Connections.

Refer to the connections state for troubleshooting. These are the possible Cloud Platform connection states:

StateDescription
Active

The connection was successfully created, configured, and is receiving data. The data collection might have started or is expected to start within the next 7 minutes.

ConfiguredThe user created a connection and configured the connection. The connection will remain in Configured state until it is manually activated. The data collection will not start until the connection is activated.
Error

A non-recoverable error occurred, so data is no longer being collected.

Inactive

The user paused the connection after the connection was created and configured.

Insufficient license

There are not enough Cisco Cloud Observability license units. Contact your Cisco Cloud Observability customer support to increase your license units.

Pending configuration

The user has successfully established a cloud connection but needs to configure the cloud service, regions, and so on.

Warning

A partial error occurred. The data is still being collected for some services.

CriticalA non-recoverable error occurred for some of the resources. The data is still being collected for other resources.

Manage Cloud Connections

Once a connection is created, you can manage the connection.

  1. Use the Cisco Cloud Observability left-hand sidebar to navigate to Configure > Cloud Connections.
  2. Clickin the connection row.
  3. Select Edit Connection, Pause Connection, or Delete Connection.

    You cannot edit the Tenant ID and Subscription ID fields. Each Subscription ID that Microsoft Azure provides is unique. Duplicate Subscription ID connections are not allowed.

    To delete a connection: After selecting Delete Connection, a Delete Connection warning appears. You are required to select Delete.

Microsoft Azure, the Microsoft Azure logo, Azure, and any other Microsoft Azure Marks used in these materials are trademarks of Microsoft Corporation or its affiliates in the United States and/or other countries.